> ## 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_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](https://docs.xbox.com/zh-CN/reference/audio/acphal/enums/acp_command_type.md) 枚举的 `ACP_COMMAND_TYPE_ENABLE_XMA_CONTEXT` 或 `ACP_COMMAND_TYPE_DISABLE_XMA_CONTEXT` 作为类型传递给 [SubmitCommand](https://docs.xbox.com/zh-CN/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_submitcommand.md)。

如果发出 `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](https://docs.xbox.com/zh-CN/reference/audio/acphal/enums/acp_command_type.md)\
[SubmitCommand](https://docs.xbox.com/zh-CN/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_submitcommand.md)\
[AcpHal](https://docs.xbox.com/zh-CN/reference/audio/acphal/acphal_members.md)


## Related topics

- [ACP_COMMAND_ENABLE_OR_DISABLE_XMA_CONTEXTS](https://docs.xbox.com/zh-CN/reference/audio/acphal/structs/acp_command_enable_or_disable_xma_contexts.md)
- [ACP_COMMAND_TYPE](https://docs.xbox.com/zh-CN/reference/audio/acphal/enums/acp_command_type.md)
- [AcpHal](https://docs.xbox.com/zh-CN/reference/audio/acphal/acphal_members.md)
- [ACP_COMMAND_UPDATE_XMA_CONTEXT](https://docs.xbox.com/zh-CN/reference/audio/acphal/structs/acp_command_update_xma_context.md)
- [ACP_COMMAND_UPDATE_XMA_CONTEXT_ENTRY](https://docs.xbox.com/zh-CN/reference/audio/acphal/structs/acp_command_update_xma_context_entry.md)