Skip to main content

ACP_COMMAND_ENABLE_OR_DISABLE_XMA_CONTEXT

Command for enabling or disabling an XMA context.

Syntax

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 enumeration) as the type to 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
SubmitCommand
AcpHal
Last modified on August 20, 2026