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

来自 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](/reference/audio/acphal/enums/acp_command_type) 枚举。) |
| 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](/reference/audio/acphal/enums/acp_message_type) 结构体使用。

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

## 要求

**头文件:** acphal.h

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

## 另请参阅

[ACP\_MESSAGE\_TYPE](/reference/audio/acphal/enums/acp_message_type)\
[AcpHal](/reference/audio/acphal/acphal_members)


## Related topics

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