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

> IAcpHal::PopMessage

# IAcpHal::PopMessage

Retorna a mensagem mais antiga na fila de mensagens do ACP e, em seguida, remove a mensagem da fila.

## Sintaxe

```cpp theme={null}
bool PopMessage(  
        ACP_MESSAGE * message
)  
```

### Parâmetros

*message*\
Tipo: [ACP\_MESSAGE\*](/pt-BR/reference/audio/acphal/structs/acp_message)

Uma cópia da mensagem mais antiga na fila.

### Valor retornado

Tipo: bool

Se uma mensagem estiver disponível e tiver sido retornada, o método retornará true; caso contrário, o método retornará false.

## Comentários

A mensagem é copiada para a memória apontada pelo parâmetro *message*. A mensagem usa a estrutura [ACP\_MESSAGE](/pt-BR/reference/audio/acphal/structs/acp_message).

Para determinar o número de mensagens na fila de mensagens, use o método [GetNumMessages](/pt-BR/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_getnummessages).

## Requisitos

**Cabeçalho:** acphal.h

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

## Confira também

[ACP\_MESSAGE](/pt-BR/reference/audio/acphal/structs/acp_message)\
[GetNumMessages](/pt-BR/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_getnummessages)\
[AcpHal](/pt-BR/reference/audio/acphal/acphal_members)


## Related topics

- [IAcpHal](/pt-BR/reference/audio/acphal/interfaces/IAcpHal/iacphal.md)
- [IAcpHal::GetNumMessages](/pt-BR/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_getnummessages.md)
- [IAcpHal::Disconnect](/pt-BR/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_disconnect.md)
- [ACP_MESSAGE](/pt-BR/reference/audio/acphal/structs/acp_message.md)
- [IAcpHal::Connect](/pt-BR/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_connect.md)