> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.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\*](/zh-TW/reference/audio/acphal/structs/acp_message)

佇列中最舊訊息的複本。

### 傳回值

類型：bool

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

## 備註

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

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

## 需求

**標頭：** acphal.h

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

## 另請參閱

[ACP\_MESSAGE](/zh-TW/reference/audio/acphal/structs/acp_message)\
[GetNumMessages](/zh-TW/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_getnummessages)\
[AcpHal](/zh-TW/reference/audio/acphal/acphal_members)


## Related topics

- [IAcpHal::PopMessage](/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_popmessage.md)
- [IAcpHal](/reference/audio/acphal/interfaces/IAcpHal/iacphal.md)