> ## 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](/zh-TW/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](/zh-TW/reference/audio/acphal/enums/acp_message_type) 結構使用。

若收到 `ACP_E_CORE_UNHANDLED_EXCEPTION` 代碼，建議終結**所有**現有的 ACP 用戶端物件，並使用 [AcpHalReleaseShapeContexts](/zh-TW/reference/audio/acphal/functions/acphalreleaseshapecontexts) 釋放已配置的 SHAPE 內容。之後應視需要分別使用 [AcpHalAllocateShapeContexts](/zh-TW/reference/audio/acphal/functions/acphalallocateshapecontexts) 和 [AcpHalCreate](/zh-TW/reference/audio/acphal/functions/acphalcreate) 重新配置/建立新的 SHAPE 內容和 ACP 用戶端物件。

## 需求

**標頭：** acphal.h

**支援的平台：** XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

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


## Related topics

- [ACP_MESSAGE_ERROR](/reference/audio/acphal/structs/acp_message_error.md)
- [ACP_MESSAGE](/reference/audio/acphal/structs/acp_message.md)