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

Command for enabling or disabling an XMA context.

## Syntax

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

### Members

*contextIndex*\
Type: UINT32

Index of the context.

## Remarks

To enable or disable the context, pass either `ACP_COMMAND_TYPE_ENABLE_XMA_CONTEXT` or `ACP_COMMAND_TYPE_DISABLE_XMA_CONTEXT` (from the [ACP\_COMMAND\_TYPE](/reference/audio/acphal/enums/acp_command_type) enumeration) as the type to [SubmitCommand](/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_submitcommand).

If the command `ACP_COMMAND_TYPE_DISABLE_XMA_CONTEXT` is issued, the `ACP_MESSAGE_TYPE_COMMAND_COMPLETED` message is sent after the XMA context is disabled and the decoder is no longer processing the context. This means that when the *command completed* message is received, a title is free to modify the context structure.

The reason the *command completed* message is sent after all the contexts are disabled by the decoder, not simply after they are marked as disabled, is that the XMA decoder could be in the middle of an operation on one or more of the contexts, which can't be interrupted. This behavior is the same as that on the XBOX 360.

## Requirements

**Header:** acphal.h

**Supported platforms:** XBOX One family consoles and XBOX Series consoles

## See also

[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)


## Related topics

- [ACP_COMMAND_TYPE](/reference/audio/acphal/enums/acp_command_type.md)
- [AcpHal](/reference/audio/acphal/acphal_members.md)
- [ACP_COMMAND_UPDATE_XMA_CONTEXT](/reference/audio/acphal/structs/acp_command_update_xma_context.md)
- [ACP_COMMAND_UPDATE_XMA_CONTEXT_ENTRY](/reference/audio/acphal/structs/acp_command_update_xma_context_entry.md)
- [ACP overview](/build/console-features/audio/overviews/acp-overview.md)