Skip to main content

SHARED_SHAPE_CONTEXTS

This structure is used when Scalable Hardware Audio Processing Engine (SHAPE) and XBOX Media Audio (XMA) resources are shared with XAudio2 instances.

Syntax

Members

shapeContexts
Type: SHAPE_CONTEXTS*
Pointer to a SHAPE_CONTEXTS structure. sharedSrcContextIndex
Type: UINT32
The index of the first Sample Rate Convertor (SRC) context to share. sharedEqCompContextIndex
Type: UINT32
The index of the first EQ/Comp context to share. sharedFiltVolContextIndex
Type: UINT32
The index of the first Filter/Volume context to share. sharedDmaContextIndex
Type: UINT32
The index of the first Direct Memory Access (DMA) context to share. sharedXmaContextIndex
Type: UINT32
The index of the first XMA context to share. sharedPcmContextIndex
Type: UINT32
The index of the first pulse-code modulation (PCM) context to share. numSharedSrcContexts
Type: UINT32
The number of SRC contexts to share, starting from sharedSrcContextIndex. numSharedEqCompContexts
Type: UINT32
The number of EQ/Comp contexts to share, starting from sharedEqCompContextIndex. numSharedFiltVolContexts
Type: UINT32
The number of Filter/Volume contexts to share, starting from sharedFiltVolContextIndex. numSharedDmaContexts
Type: UINT32
The number of DMA contexts to share, starting from sharedDmaContextIndex. numSharedXmaContexts
Type: UINT32
The number of XMA contexts to share, starting from sharedXmaContextIndex. numSharedPcmContexts
Type: UINT32
The number of PCM contexts to share, starting from sharedPcmContextIndex.

Remarks

This structure is used by the XAudio2CreateWithSharedContexts function. The function works the same way as XAudio2Create but takes SHARED_SHAPE_CONTEXTS as an additional parameter. You can share state for SHAPE across multiple IXAudio2 instances.

Requirements

Header: acphal.h Supported platforms: XBOX One family consoles and XBOX Series consoles

See also

XAudio2CreateWithSharedContexts
XAudio2Create
AcpHal
Last modified on August 20, 2026