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

> ACP_MESSAGE_ERROR

# ACP\_MESSAGE\_ERROR

Mensagem de erro do ACP.

## Sintaxe

```cpp theme={null}
typedef struct ACP_MESSAGE_ERROR {  
    HRESULT errorCode; 
    UINT32 additionalData;  
} ACP_MESSAGE_ERROR  
```

### Membros

*errorCode*\
Tipo: HRESULT

Código de erro.

*additionalData*\
Tipo: UINT32

Dados adicionais relevantes para o erro.

## Comentários

Os valores retornados em *errorCode* têm os significados a seguir.

| *errorCode* | Descrição |
| - | - |
| ACP\_E\_ALREADY\_ALLOCATED | Os dados já estão alocados. |
| ACP\_E\_ALREADY\_CONNECTED | A instância já está conectada ao ACP. |
| ACP\_E\_ALREADY\_REGISTERED | Já registrado. |
| ACP\_E\_INVALID\_COMMAND | O comando não é válido; *additionalData* contém o `commandId`. |
| ACP\_E\_INVALID\_COMMAND\_TYPE | O tipo de comando não é válido. (Consulte a enumeração [ACP\_COMMAND\_TYPE](/pt-BR/reference/audio/acphal/enums/acp_command_type).) |
| ACP\_E\_INVALID\_CONTEXT\_DATA | Os dados de contexto não são válidos. |
| ACP\_E\_INVALID\_FLOWGRAPH | O flowgraph especificado não é válido. Examine os cabeçalhos das entradas do flowgraph; as entradas inválidas têm o bit de erro definido. |
| ACP\_E\_INVALID\_MESSAGE\_TYPE | O tipo de mensagem não é válido. |
| ACP\_E\_INVALID\_XMA\_CONTEXT | O índice do contexto XMA não é válido. |
| ACP\_E\_MESSAGE\_ALREADY\_REGISTERED | O tipo de mensagem não pode ser registrado porque já está registrado. |
| ACP\_E\_MESSAGE\_NOT\_REGISTERED | O registro do tipo de mensagem não pode ser cancelado porque ele não está registrado. |
| ACP\_E\_NOT\_ALLOCATED | Os dados não foram alocados. |
| ACP\_E\_NOT\_CONNECTED | A instância não está conectada ao ACP. |
| ACP\_E\_NOT\_REGISTERED | Não registrado. |
| ACP\_E\_QUEUE\_FULL | A fila de comandos está cheia. |
| ACP\_E\_STILL\_CONNECTED | A operação tentada não pode ser realizada enquanto houver conexão com o ACP. |
| ACP\_E\_XMA\_PARSER\_ERROR | O contexto XMA gerou um erro do analisador; *additionalData* contém o índice do contexto XMA. |
| ACP\_E\_CORE\_UNHANDLED\_EXCEPTION | O núcleo encontrou uma exceção sem tratamento e agora falhou/travou. |

Essa estrutura é usada pela mensagem `ACP_MESSAGE_TYPE_ERROR`. Essa estrutura também é usada pela estrutura [ACP\_MESSAGE\_TYPE](/pt-BR/reference/audio/acphal/enums/acp_message_type).

Ao receber um código `ACP_E_CORE_UNHANDLED_EXCEPTION`, é recomendável que **todos** os objetos cliente do ACP existentes sejam destruídos e que os contextos SHAPE alocados sejam liberados usando [AcpHalReleaseShapeContexts](/pt-BR/reference/audio/acphal/functions/acphalreleaseshapecontexts). Novos contextos SHAPE e objetos cliente do ACP devem ser alocados/criados novamente conforme necessário usando [AcpHalAllocateShapeContexts](/pt-BR/reference/audio/acphal/functions/acphalallocateshapecontexts) e [AcpHalCreate](/pt-BR/reference/audio/acphal/functions/acphalcreate), respectivamente.

## 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)\
[AcpHal](/pt-BR/reference/audio/acphal/acphal_members)


## Related topics

- [ACP_MESSAGE](/pt-BR/reference/audio/acphal/structs/acp_message.md)
- [AcpHal](/pt-BR/reference/audio/acphal/acphal_members.md)
- [ACP_MESSAGE_TYPE](/pt-BR/reference/audio/acphal/enums/acp_message_type.md)
- [ACP_COMMAND_MESSAGE](/pt-BR/reference/audio/acphal/structs/acp_command_message.md)
- [ACP_MESSAGE_FLOWGRAPH_COMPLETED](/pt-BR/reference/audio/acphal/structs/acp_message_flowgraph_completed.md)