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

> ACP_COMMAND_ENABLE_OR_DISABLE_XMA_CONTEXTS

# ACP\_COMMAND\_ENABLE\_OR\_DISABLE\_XMA\_CONTEXTS

一連の XMA コンテキストを有効または無効にするためのコマンドです。

## 構文

```cpp theme={null}
typedef struct ACP_COMMAND_ENABLE_OR_DISABLE_XMA_CONTEXTS {  
    UINT32 context[SHAPE_NUM_XMA_CONTEXT_BITFIELDS];  
} ACP_COMMAND_ENABLE_OR_DISABLE_XMA_CONTEXTS  
```

### メンバー

*context*\
型: UINT32\[SHAPE\_NUM\_XMA\_CONTEXT\_BITFIELDS]

コンテキストのビットフィールドです。配列要素 = context / 32、マスク = 1 \<\< (context % 32) となります。

## 解説

コマンド `ACP_COMMAND_TYPE_DISABLE_XMA_CONTEXTS` が発行された場合、`ACP_MESSAGE_TYPE_COMMAND_COMPLETED` メッセージは、すべての XMA コンテキストが無効になり、デコーダーがどのコンテキストも処理しなくなった後に送信されます。つまり、*コマンド完了*メッセージを受信した時点で、タイトルはコンテキスト構造体を自由に変更できます。

*コマンド完了*メッセージが、コンテキストが無効としてマークされた直後ではなく、デコーダーによってコンテキストが無効にされた後に送信される理由は、XMA デコーダーがコンテキストに対して中断できない操作を実行している途中である可能性があるためです。この動作は XBOX 360 の場合と同じです。

コンテキスト配列全体がゼロに初期化されている場合は、次のコードを使用して各コンテキスト インデックスのビットを設定します。

`context[contextIndex >> SHAPE_XMA_CONTEXT_INDEX_SHIFT] |= 1 << (contextIndex & SHAPE_XMA_CONTEXT_BIT_MASK);`

## 要件

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

**サポートされているプラットフォーム:** XBOX One ファミリ コンソールおよび XBOX Series コンソール

## 関連項目

[ACP\_COMMAND\_TYPE](https://docs.xbox.com/ja-jp/reference/audio/acphal/enums/acp_command_type.md)\
[SubmitCommand](https://docs.xbox.com/ja-jp/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_submitcommand.md)\
[AcpHal](https://docs.xbox.com/ja-jp/reference/audio/acphal/acphal_members.md)


## Related topics

- [ACP_COMMAND_ENABLE_OR_DISABLE_XMA_CONTEXT](https://docs.xbox.com/ja-jp/reference/audio/acphal/structs/acp_command_enable_or_disable_xma_context.md)
- [ACP_COMMAND_TYPE](https://docs.xbox.com/ja-jp/reference/audio/acphal/enums/acp_command_type.md)
- [AcpHal](https://docs.xbox.com/ja-jp/reference/audio/acphal/acphal_members.md)
- [ACP_COMMAND_UPDATE_XMA_CONTEXT](https://docs.xbox.com/ja-jp/reference/audio/acphal/structs/acp_command_update_xma_context.md)
- [ACP_COMMAND_UPDATE_XMA_CONTEXT_ENTRY](https://docs.xbox.com/ja-jp/reference/audio/acphal/structs/acp_command_update_xma_context_entry.md)