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

Retourne le message le plus ancien de la file d'attente des messages de l'ACP, puis supprime le message de la file d'attente.

## Syntaxe

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

### Paramètres

*message*\
Type : [ACP\_MESSAGE\*](https://docs.xbox.com/fr-CA/reference/audio/acphal/structs/acp_message.md)

Une copie du message le plus ancien de la file d'attente.

### Valeur de retour

Type : bool

Si un message est disponible et a été retourné, la méthode retourne true; sinon, elle retourne false.

## Remarques

Le message est copié dans la mémoire pointée par le paramètre *message*. Le message utilise la structure [ACP\_MESSAGE](https://docs.xbox.com/fr-CA/reference/audio/acphal/structs/acp_message.md).

Pour déterminer le nombre de messages dans la file d'attente des messages, utilisez la méthode [GetNumMessages](https://docs.xbox.com/fr-CA/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_getnummessages.md).

## Configuration requise

**En-tête :** acphal.h

**Plateformes prises en charge :** consoles de la famille XBOX One et consoles XBOX Series

## Voir aussi

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


## Related topics

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