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

# GetShapeDmaReadWriteFull

> GetShapeDmaReadWriteFull

# GetShapeDmaReadWriteFull

获取一个 32 位值,其中包含读指针、写指针以及缓冲区满标志。

## Syntax

```cpp theme={null}
SHAPE_DMA_READ_WRITE_FULL GetShapeDmaReadWriteFull(  
         const SHAPE_DMA_CONTEXT* context  
)  
```

### Parameters

*context*   \_In\_\
Type: [SHAPE\_DMA\_CONTEXT\*](https://docs.xbox.com/zh-CN/reference/audio/shapedmacontext/structs/shape_dma_context.md)

指向 [SHAPE\_DMA\_CONTEXT](https://docs.xbox.com/zh-CN/reference/audio/shapedmacontext/structs/shape_dma_context.md) 结构的指针。

### Return value

Type: SHAPE\_DMA\_READ\_WRITE\_FULL

一个 32 位值,包含读指针、写指针以及缓冲区满标志。请参阅 [SHAPE\_DMA\_READ\_WRITE\_FULL](https://docs.xbox.com/zh-CN/reference/audio/shapedmacontext/structs/shape_dma_read_write_full.md) 结构。

## Remarks

此原子操作可保证这三个值保持同步。

任何附加的可扩展硬件音频处理引擎 (SHAPE) 处理都通过读写临时混合缓冲区来完成。所执行的处理由音频控制处理器 (ACP) 控制,而 ACP 本身由应用程序通过 [AcpHal](https://docs.xbox.com/zh-CN/reference/audio/acphal/acphal_members.md) API 驱动。这些处理包括均衡、压缩、滤波器缩放和音量缩放。

## Requirements

**头文件:** shapedmacontext.h

**支持的平台:** XBOX One 系列主机和 XBOX Series 主机

## See also

[SHAPE\_DMA\_READ\_WRITE\_FULL](https://docs.xbox.com/zh-CN/reference/audio/shapedmacontext/structs/shape_dma_read_write_full.md)\
[ShapeDmaContext](https://docs.xbox.com/zh-CN/reference/audio/shapedmacontext/shapedmacontext_members.md)


## Related topics

- [SHAPE_DMA_READ_WRITE_FULL](https://docs.xbox.com/zh-CN/reference/audio/shapedmacontext/structs/shape_dma_read_write_full.md)
- [ShapeDmaContext](https://docs.xbox.com/zh-CN/reference/audio/shapedmacontext/shapedmacontext_members.md)
- [SetShapeDmaReadWriteFull](https://docs.xbox.com/zh-CN/reference/audio/shapedmacontext/functions/setshapedmareadwritefull.md)
- [GetShapeDmaBufferFull](https://docs.xbox.com/zh-CN/reference/audio/shapedmacontext/functions/getshapedmabufferfull.md)
- [GetShapeDmaWritePointer](https://docs.xbox.com/zh-CN/reference/audio/shapedmacontext/functions/getshapedmawritepointer.md)