Skip to main content

ACP_COMMAND_UPDATE_XMA_CONTEXT_ENTRY

Entry for updating a SHAPE_XMA_CONTEXT.

Syntax

Members

contextIndex
Type: UINT32
Index in the range of 0 to ACP_MAX_NUM_XMA_CONTEXTS. ptrRead0
Type: APU_ADDRESS
Replaces the existing value of SHAPE_XMA_CONTEXT::ptrRead0. ptrRead1
Type: APU_ADDRESS
Replaces the existing value of SHAPE_XMA_CONTEXT::ptrRead1. sizeRead0
Type: UINT16
Replaces the existing value of SHAPE_XMA_CONTEXT::sizeRead0. sizeRead1
Type: UINT16
Replaces the existing value of SHAPE_XMA_CONTEXT::sizeRead1. writeBufferOffsetRead
Type: UINT16
Replaces the existing value of SHAPE_XMA_CONTEXT::writeBufferOffsetRead. validBuffer
Type: UINT16
Replaces the existing value of SHAPE_XMA_CONTEXT::validBuffer.

Remarks

This structure is used by ACP_COMMAND_UPDATE_CONTEXTS and ACP_COMMAND_UPDATE_ALL_CONTEXTS commands to update a single PCM context. Use the command to update only a small number of contexts per audio frame; updating a large number of contexts is not efficient. See the Rendering audio section of Overview of ACP for more detail.

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