> ## 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/ja-jp/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/ja-jp/reference/audio/acphal/enums/acp_message_type.md) 構造体でも使用されます。

`ACP_E_CORE_UNHANDLED_EXCEPTION` コードを受信した場合、既存の **すべての** ACP クライアント オブジェクトを破棄し、[AcpHalReleaseShapeContexts](https://docs.xbox.com/ja-jp/reference/audio/acphal/functions/acphalreleaseshapecontexts.md) を使用して割り当て済みの SHAPE コンテキストを解放することを推奨します。新しい SHAPE コンテキストと ACP クライアント オブジェクトは、必要に応じてそれぞれ [AcpHalAllocateShapeContexts](https://docs.xbox.com/ja-jp/reference/audio/acphal/functions/acphalallocateshapecontexts.md) と [AcpHalCreate](https://docs.xbox.com/ja-jp/reference/audio/acphal/functions/acphalcreate.md) を使用して再度割り当て/作成してください。

## 要件

**ヘッダー:** acphal.h

**サポート対象プラットフォーム:** XBOX One ファミリー本体、XBOX Series 本体

## 関連項目

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


## Related topics

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