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

> ACP_COMMAND_ENABLE_OR_DISABLE_XMA_CONTEXT

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

启用或禁用某个 XMA 上下文的命令。

## 语法

```cpp theme={null}
typedef struct ACP_COMMAND_ENABLE_OR_DISABLE_XMA_CONTEXT {  
    UINT32 contextIndex;  
} ACP_COMMAND_ENABLE_OR_DISABLE_XMA_CONTEXT  
```

### 成员

*contextIndex*\
类型:UINT32

上下文的索引。

## 备注

若要启用或禁用上下文,请将来自 [ACP\_COMMAND\_TYPE](/reference/audio/acphal/enums/acp_command_type) 枚举的 `ACP_COMMAND_TYPE_ENABLE_XMA_CONTEXT` 或 `ACP_COMMAND_TYPE_DISABLE_XMA_CONTEXT` 作为类型传递给 [SubmitCommand](/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_submitcommand)。

如果发出 `ACP_COMMAND_TYPE_DISABLE_XMA_CONTEXT` 命令,则会在 XMA 上下文被禁用且解码器不再处理该上下文之后,发送 `ACP_MESSAGE_TYPE_COMMAND_COMPLETED` 消息。这意味着当收到 *command completed* 消息时,游戏可以自由地修改该上下文结构体。

之所以在所有上下文都被解码器禁用之后(而不是仅在被标记为禁用之后)才发送 *command completed* 消息,是因为 XMA 解码器可能正在对一个或多个上下文执行不可中断的操作。此行为与 XBOX 360 上的行为相同。

## 要求

**头文件:** acphal.h

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

## 另请参阅

[ACP\_COMMAND\_TYPE](/reference/audio/acphal/enums/acp_command_type)\
[SubmitCommand](/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_submitcommand)\
[AcpHal](/reference/audio/acphal/acphal_members)