Skip to main content

SetShapeDmaReadWriteFull

Sets the read and write pointers and buffer-full flag in a single atomic operation.

Syntax

Parameters

context   _Inout_
Type: SHAPE_DMA_CONTEXT*
Pointer to a SHAPE_DMA_CONTEXT structure. readWriteFull   
Type: SHAPE_DMA_READ_WRITE_FULL
32-bit value that contains the read pointer, the write pointer, and the buffer-full flag. Refer to the SHAPE_DMA_READ_WRITE_FULL structure.

Return value

Type: HRESULT HRESULT success or error code.

Remarks

This atomic operation guarantees that the three values are in sync. Any additional Scalable Hardware Audio Processing Engine (SHAPE) processing is performed by reading and writing to temporary mix buffers. The processing performed is controlled by the Audio Control Processor (ACP), which itself is driven by the application through the AcpHal API. These processes include equalizing, compression, filter scaling, and volume scaling.

Requirements

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

See also

SHAPE_DMA_READ_WRITE_FULL
ShapeDmaContext
Last modified on August 20, 2026