> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SetShapeDmaReadWriteFull

> SetShapeDmaReadWriteFull

# SetShapeDmaReadWriteFull

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

## Syntax

```cpp theme={null}
HRESULT SetShapeDmaReadWriteFull(  
         SHAPE_DMA_CONTEXT* context,  
         SHAPE_DMA_READ_WRITE_FULL readWriteFull  
)  
```

### Parameters

*context*   \_Inout\_\
Type: [SHAPE\_DMA\_CONTEXT\*](/reference/audio/shapedmacontext/structs/shape_dma_context)

Pointer to a [SHAPE\_DMA\_CONTEXT](/reference/audio/shapedmacontext/structs/shape_dma_context) structure.

*readWriteFull*   \
Type: [SHAPE\_DMA\_READ\_WRITE\_FULL](/reference/audio/shapedmacontext/structs/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](/reference/audio/shapedmacontext/structs/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](/reference/audio/acphal/acphal_members) 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](/reference/audio/shapedmacontext/structs/shape_dma_read_write_full)\
[ShapeDmaContext](/reference/audio/shapedmacontext/shapedmacontext_members)


## Related topics

- [ShapeDmaContext](/reference/audio/shapedmacontext/shapedmacontext_members.md)
- [SHAPE_DMA_READ_WRITE_FULL](/reference/audio/shapedmacontext/structs/shape_dma_read_write_full.md)
- [GetShapeDmaReadWriteFull](/reference/audio/shapedmacontext/functions/getshapedmareadwritefull.md)
- [SetShapeDmaBufferFull](/reference/audio/shapedmacontext/functions/setshapedmabufferfull.md)
- [SetShapeDmaWritePointer](/reference/audio/shapedmacontext/functions/setshapedmawritepointer.md)