> ## 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::GetNumMessages

> IAcpHal::GetNumMessages

# IAcpHal::GetNumMessages

傳回訊息佇列中的訊息數目。

## 語法

```cpp theme={null}
UINT32 GetNumMessages(  
)  
```

### 參數

此方法沒有參數。

### 傳回值

類型：UINT32

佇列中的訊息數目。

## 備註

傳回的值是在某個精確時間點佇列中的訊息數目。此值可能只在短時間內準確。呼叫端可確保佇列中的訊息數目絕不會少於傳回的值，但當然可能會更多。若要從佇列取得訊息，請使用 [PopMessage](https://docs.xbox.com/zh-TW/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_popmessage.md) 方法。

## 需求

**標頭：** acphal.h

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

## 另請參閱

[PopMessage](https://docs.xbox.com/zh-TW/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_popmessage.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::PopMessage](https://docs.xbox.com/zh-TW/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_popmessage.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)
- [IAcpHal::Disconnect](https://docs.xbox.com/zh-TW/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_disconnect.md)