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

> IAcpHal::GetNumMessages

# IAcpHal::GetNumMessages

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

## 語法

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

### 參數

此方法沒有參數。

### 傳回值

類型：UINT32

佇列中的訊息數目。

## 備註

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

## 需求

**標頭：** acphal.h

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

## 另請參閱

[PopMessage](/zh-TW/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_popmessage)\
[AcpHal](/zh-TW/reference/audio/acphal/acphal_members)


## Related topics

- [IAcpHal::GetNumMessages](/ko/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_getnummessages.md)
- [IAcpHal](/reference/audio/acphal/interfaces/IAcpHal/iacphal.md)