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

# ACP_MESSAGE

> ACP_MESSAGE

# ACP\_MESSAGE

Mensagem do ACP.

## Sintaxe

```cpp theme={null}
typedef struct ACP_MESSAGE {  
    UINT32 type;  
    UINT32 droppedMessageCount;  
    UINT32 usec;  
    union  
    {  
        ACP_MESSAGE_AUDIO_FRAME_START audioFrameStart;  
        ACP_MESSAGE_FLOWGRAPH_COMPLETED flowgraphCompleted;  
        ACP_MESSAGE_SHAPE_COMMAND_BLOCKED shapeCommandBlocked;  
        ACP_MESSAGE_COMMAND_COMPLETED commandCompleted;  
        ACP_MESSAGE_FLOWGRAPH_TERMINATED flowgraphTerminated;  
        ACP_MESSAGE_ERROR error;  
    };  
} ACP_MESSAGE  
```

### Membros

*type*\
Tipo: UINT32

Tipo de mensagem; consulte [ACP\_MESSAGE\_TYPE](/pt-BR/reference/audio/acphal/enums/acp_message_type).

*droppedMessageCount*\
Tipo: UINT32

Contagem de mensagens descartadas antes desta mensagem.

*usec*\
Tipo: UINT32

O momento em que esta mensagem foi construída.

*audioFrameStart*\
Tipo: [ACP\_MESSAGE\_AUDIO\_FRAME\_START](/pt-BR/reference/audio/acphal/structs/acp_message_audio_frame_start)

Uma mensagem [ACP\_MESSAGE\_AUDIO\_FRAME\_START](/pt-BR/reference/audio/acphal/structs/acp_message_audio_frame_start).

*flowgraphCompleted*\
Tipo: [ACP\_MESSAGE\_FLOWGRAPH\_COMPLETED](/pt-BR/reference/audio/acphal/structs/acp_message_flowgraph_completed)

Uma mensagem [ACP\_MESSAGE\_FLOWGRAPH\_COMPLETED](/pt-BR/reference/audio/acphal/structs/acp_message_flowgraph_completed).

*shapeCommandBlocked*\
Tipo: [ACP\_MESSAGE\_SHAPE\_COMMAND\_BLOCKED](/pt-BR/reference/audio/acphal/structs/acp_message_shape_command_blocked)

Uma mensagem [ACP\_MESSAGE\_SHAPE\_COMMAND\_BLOCKED](/pt-BR/reference/audio/acphal/structs/acp_message_shape_command_blocked).

*commandCompleted*\
Tipo: [ACP\_MESSAGE\_COMMAND\_COMPLETED](/pt-BR/reference/audio/acphal/structs/acp_message_command_completed)

Uma mensagem [ACP\_MESSAGE\_COMMAND\_COMPLETED](/pt-BR/reference/audio/acphal/structs/acp_message_command_completed).

*flowgraphTerminated*\
Tipo: [ACP\_MESSAGE\_FLOWGRAPH\_TERMINATED](/pt-BR/reference/audio/acphal/structs/acp_message_flowgraph_terminated)

Uma mensagem [ACP\_MESSAGE\_FLOWGRAPH\_TERMINATED](/pt-BR/reference/audio/acphal/structs/acp_message_flowgraph_terminated).

*error*\
Tipo: [ACP\_MESSAGE\_ERROR](/pt-BR/reference/audio/acphal/structs/acp_message_error)

Uma mensagem [ACP\_MESSAGE\_ERROR](/pt-BR/reference/audio/acphal/structs/acp_message_error).

## Comentários

Para determinar o tipo da mensagem, examine o membro *type*.

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). Para obter a mensagem mais antiga da fila, use o método [PopMessage](/pt-BR/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_popmessage).

## Requisitos

**Cabeçalho:** acphal.h

**Plataformas compatíveis:** consoles da família XBOX One e consoles XBOX Series

## Confira também

[ACP\_MESSAGE\_TYPE](/pt-BR/reference/audio/acphal/enums/acp_message_type)\
[GetNumMessages](/pt-BR/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_getnummessages)\
[PopMessage](/pt-BR/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_popmessage)\
[AcpHal](/pt-BR/reference/audio/acphal/acphal_members)


## Related topics

- [ACP_MESSAGE_TYPE](/pt-BR/reference/audio/acphal/enums/acp_message_type.md)
- [IAcpHal::PopMessage](/pt-BR/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_popmessage.md)
- [Visão geral do SHAPE](/pt-BR/build/console-features/audio/overviews/shape-overview.md)
- [Práticas recomendadas para construção de flowgraphs de áudio do SHAPE](/pt-BR/build/console-features/audio/overviews/best-practices-audio-flowgraph-construction.md)
- [AcpHal](/pt-BR/reference/audio/acphal/acphal_members.md)