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

# ACP_MESSAGE_ERROR

> ACP_MESSAGE_ERROR

# ACP\_MESSAGE\_ERROR

来自 ACP 的错误消息。

## 语法

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

### 成员

*errorCode*\
类型:HRESULT

错误代码。

*additionalData*\
类型:UINT32

与错误相关的附加数据。

## 备注

*errorCode* 中返回的值具有以下含义。

| *errorCode* | 描述 |
| - | - |
| ACP\_E\_ALREADY\_ALLOCATED | 数据已被分配。 |
| ACP\_E\_ALREADY\_CONNECTED | 此实例已连接到 ACP。 |
| ACP\_E\_ALREADY\_REGISTERED | 已注册。 |
| ACP\_E\_INVALID\_COMMAND | 命令无效;*additionalData* 包含该 `commandId`。 |
| ACP\_E\_INVALID\_COMMAND\_TYPE | 命令类型无效。(参见 [ACP\_COMMAND\_TYPE](https://docs.xbox.com/zh-CN/reference/audio/acphal/enums/acp_command_type.md) 枚举。) |
| ACP\_E\_INVALID\_CONTEXT\_DATA | 上下文数据无效。 |
| ACP\_E\_INVALID\_FLOWGRAPH | 指定的流程图无效。检查流程图条目头;无效条目会设置错误位。 |
| ACP\_E\_INVALID\_MESSAGE\_TYPE | 消息类型无效。 |
| ACP\_E\_INVALID\_XMA\_CONTEXT | XMA 上下文的索引无效。 |
| ACP\_E\_MESSAGE\_ALREADY\_REGISTERED | 该消息类型无法注册,因为它已注册。 |
| ACP\_E\_MESSAGE\_NOT\_REGISTERED | 该消息类型无法注销,因为它未注册。 |
| ACP\_E\_NOT\_ALLOCATED | 数据未分配。 |
| ACP\_E\_NOT\_CONNECTED | 此实例未连接到 ACP。 |
| ACP\_E\_NOT\_REGISTERED | 未注册。 |
| ACP\_E\_QUEUE\_FULL | 命令队列已满。 |
| ACP\_E\_STILL\_CONNECTED | 在连接到 ACP 时无法进行尝试的操作。 |
| ACP\_E\_XMA\_PARSER\_ERROR | XMA 上下文产生了解析器错误;*additionalData* 包含该 XMA 上下文的索引。 |
| ACP\_E\_CORE\_UNHANDLED\_EXCEPTION | 核心遇到了未处理的异常,现在已崩溃/挂起。 |

此结构体由 `ACP_MESSAGE_TYPE_ERROR` 消息使用。此结构体也由 [ACP\_MESSAGE\_TYPE](https://docs.xbox.com/zh-CN/reference/audio/acphal/enums/acp_message_type.md) 结构体使用。

如果收到 `ACP_E_CORE_UNHANDLED_EXCEPTION` 代码,建议销毁**所有**现有的 ACP 客户端对象,并使用 [AcpHalReleaseShapeContexts](https://docs.xbox.com/zh-CN/reference/audio/acphal/functions/acphalreleaseshapecontexts.md) 释放已分配的 SHAPE 上下文。之后应根据需要,分别使用 [AcpHalAllocateShapeContexts](https://docs.xbox.com/zh-CN/reference/audio/acphal/functions/acphalallocateshapecontexts.md) 和 [AcpHalCreate](https://docs.xbox.com/zh-CN/reference/audio/acphal/functions/acphalcreate.md) 重新分配/创建新的 SHAPE 上下文和 ACP 客户端对象。

## 要求

**头文件:** acphal.h

**支持的平台:** XBOX One 系列主机和 XBOX Series 主机

## 另请参阅

[ACP\_MESSAGE\_TYPE](https://docs.xbox.com/zh-CN/reference/audio/acphal/enums/acp_message_type.md)\
[AcpHal](https://docs.xbox.com/zh-CN/reference/audio/acphal/acphal_members.md)


## Related topics

- [ACP_MESSAGE](https://docs.xbox.com/zh-CN/reference/audio/acphal/structs/acp_message.md)
- [AcpHal](https://docs.xbox.com/zh-CN/reference/audio/acphal/acphal_members.md)
- [ACP_MESSAGE_TYPE](https://docs.xbox.com/zh-CN/reference/audio/acphal/enums/acp_message_type.md)
- [ACP_COMMAND_MESSAGE](https://docs.xbox.com/zh-CN/reference/audio/acphal/structs/acp_command_message.md)
- [ACP_MESSAGE_COMMAND_COMPLETED](https://docs.xbox.com/zh-CN/reference/audio/acphal/structs/acp_message_command_completed.md)