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

> IAcpHal::PopMessage

# IAcpHal::PopMessage

Devuelve el mensaje más antiguo de la cola de mensajes del ACP y, a continuación, quita el mensaje de la cola.

## Sintaxis

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

### Parámetros

*message*\
Tipo: [ACP\_MESSAGE\*](https://docs.xbox.com/es/reference/audio/acphal/structs/acp_message.md)

Una copia del mensaje más antiguo de la cola.

### Valor devuelto

Tipo: bool

Si hay un mensaje disponible y se devolvió, el método devuelve true; de lo contrario, el método devuelve false.

## Comentarios

El mensaje se copia en la memoria a la que apunta el parámetro *message*. El mensaje usa la estructura [ACP\_MESSAGE](https://docs.xbox.com/es/reference/audio/acphal/structs/acp_message.md).

Para determinar el número de mensajes de la cola de mensajes, use el método [GetNumMessages](https://docs.xbox.com/es/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_getnummessages.md).

## Requisitos

**Encabezado:** acphal.h

**Plataformas compatibles:** consolas de la familia XBOX One y consolas XBOX Series

## Consulte también

[ACP\_MESSAGE](https://docs.xbox.com/es/reference/audio/acphal/structs/acp_message.md)\
[GetNumMessages](https://docs.xbox.com/es/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_getnummessages.md)\
[AcpHal](https://docs.xbox.com/es/reference/audio/acphal/acphal_members.md)


## Related topics

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