> ## 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](/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_popmessage) 方法。

## 要求

**头文件:** acphal.h

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

## 另请参阅

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


## Related topics

- [IAcpHal](/zh-CN/reference/audio/acphal/interfaces/IAcpHal/iacphal.md)
- [IAcpHal::PopMessage](/zh-CN/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_popmessage.md)
- [ACP_MESSAGE](/zh-CN/reference/audio/acphal/structs/acp_message.md)
- [IAcpHal::Connect](/zh-CN/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_connect.md)
- [IAcpHal::Disconnect](/zh-CN/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_disconnect.md)