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

Returns the number of messages in the message queue.

## Syntax

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

### Parameters

This method has no parameters.

### Return value

Type: UINT32

The number of messages in the queue.

## Remarks

The value returned is the number of messages in the queue at a precise point in time. This value will likely be accurate only for a brief period. The caller is guaranteed that the number of messages in the queue will never be less than the value returned, although it could certainly be greater. To obtain a message from the queue, use the [PopMessage](https://docs.xbox.com/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_popmessage.md) method.

## Requirements

**Header:** acphal.h

**Supported platforms:** XBOX One family consoles and XBOX Series consoles

## See also

[PopMessage](https://docs.xbox.com/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_popmessage.md)\
[AcpHal](https://docs.xbox.com/reference/audio/acphal/acphal_members.md)


## Related topics

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