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

Retorna o número de mensagens na fila de mensagens.

## Sintaxe

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

### Parâmetros

Este método não tem parâmetros.

### Valor retornado

Tipo: UINT32

O número de mensagens na fila.

## Comentários

O valor retornado é o número de mensagens na fila em um momento preciso. Esse valor provavelmente será preciso apenas por um breve período. É garantido ao chamador que o número de mensagens na fila nunca será menor que o valor retornado, embora certamente possa ser maior. Para obter uma mensagem da fila, use o método [PopMessage](https://docs.xbox.com/pt-BR/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_popmessage.md).

## Requisitos

**Cabeçalho:** acphal.h

**Plataformas com suporte:** consoles da família XBOX One e consoles XBOX Series

## Confira também

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


## Related topics

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