> ## 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-TW/reference/audio/acphal/structs/acp_message.md)

佇列中最舊訊息的複本。

### 傳回值

類型：bool

如果有可用的訊息且已傳回，此方法會傳回 true；否則，此方法會傳回 false。

## 備註

訊息會複製到 *message* 參數所指向的記憶體。訊息使用 [ACP\_MESSAGE](https://docs.xbox.com/zh-TW/reference/audio/acphal/structs/acp_message.md) 結構。

若要判斷訊息佇列中的訊息數目，請使用 [GetNumMessages](https://docs.xbox.com/zh-TW/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_getnummessages.md) 方法。

## 需求

**標頭：** acphal.h

**支援的平台：** XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

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


## Related topics

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