ACP_COMMAND_ENABLE_OR_DISABLE_XMA_CONTEXT Structure

Command to enable or disable an XMA context.

Syntax

struct ACP_COMMAND_ENABLE_OR_DISABLE_XMA_CONTEXT {
    UINT32 contextIndex;
};  

Members

contextIndex
Index of 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 will be 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 why the command completed message is sent after all the contexts are disabled by the decoder, and 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 cannot be interrupted. This behavior is the same as on the Xbox 360.

Requirements

Header: Declared in acphal.h.

Library: Use acphal.lib.