> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# IAcpHal::PopMessage

> IAcpHal::PopMessage

# IAcpHal::PopMessage

返回 ACP 消息队列中最早的消息,然后将其从队列中移除。

## 语法

```cpp theme={null}
bool PopMessage(  
        ACP_MESSAGE * message
)  
```

### 参数

*message*\
类型:[ACP\_MESSAGE\*](https://docs.xbox.com/zh-CN/reference/audio/acphal/structs/acp_message.md)

队列中最早消息的副本。

### 返回值

类型:bool

如果有可用消息并已返回,则该方法返回 true;否则返回 false。

## 备注

消息被复制到 *message* 参数所指向的内存中。该消息使用 [ACP\_MESSAGE](https://docs.xbox.com/zh-CN/reference/audio/acphal/structs/acp_message.md) 结构体。

若要确定消息队列中的消息数量,请使用 [GetNumMessages](https://docs.xbox.com/zh-CN/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_getnummessages.md) 方法。

## 要求

**头文件:** acphal.h

**支持的平台:** XBOX One 系列主机和 XBOX Series 主机

## 另请参阅

[ACP\_MESSAGE](https://docs.xbox.com/zh-CN/reference/audio/acphal/structs/acp_message.md)\
[GetNumMessages](https://docs.xbox.com/zh-CN/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_getnummessages.md)\
[AcpHal](https://docs.xbox.com/zh-CN/reference/audio/acphal/acphal_members.md)


## Related topics

- [IAcpHal](https://docs.xbox.com/zh-CN/reference/audio/acphal/interfaces/IAcpHal/iacphal.md)
- [IAcpHal::GetNumMessages](https://docs.xbox.com/zh-CN/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_getnummessages.md)
- [IAcpHal::Disconnect](https://docs.xbox.com/zh-CN/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_disconnect.md)
- [ACP_MESSAGE](https://docs.xbox.com/zh-CN/reference/audio/acphal/structs/acp_message.md)
- [IAcpHal::Connect](https://docs.xbox.com/zh-CN/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_connect.md)