> ## 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.

# GetShapeFiltVolMixBufferPeakMagnitude

> GetShapeFiltVolMixBufferPeakMagnitude

# GetShapeFiltVolMixBufferPeakMagnitude

获取输出混音缓冲区的峰值幅度。

## 语法

```cpp theme={null}
float GetShapeFiltVolMixBufferPeakMagnitude(  
         const SHAPE_FILTVOL_CONTEXT* context  
)  
```

### 参数

*context*   \_In\_\
类型:[SHAPE\_FILTVOL\_CONTEXT](/reference/audio/shapefiltvolcontext/structs/shape_filtvol_context)\*

指向 [SHAPE\_FILTVOL\_CONTEXT](/reference/audio/shapefiltvolcontext/structs/shape_filtvol_context) 对象的指针。

### 返回值

类型:float

峰值幅度。

## 注解

除了监测每个硬件模块自身的峰值幅度外,还会维护混音缓冲区的峰值幅度。当硬件模块的输出被累加到混音缓冲区时,峰值幅度以相同方式计算:通过统计前导零的数量得出。每个硬件模块的状态会额外维护一对 4 位的峰值幅度值。这些值表示硬件模块的输出累加到混音缓冲区后,该混音缓冲区的峰值幅度。其中一个 4 位数字表示持续保持的峰值幅度;另一个则每个音频帧都更新。峰值幅度值保存在可扩展硬件音频处理引擎(SHAPE)模块的上下文中,尽管所表示的是混音缓冲区状态。

有关详细信息,请参阅 [SHAPE 概述](/build/console-features/audio/overviews/shape-overview) 中的 [溢出、幅度与饱和](/build/console-features/audio/overviews/shape-overview#ID4ELAAC)。

## 要求

**头文件:** shapefiltvolcontext.h

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

## 另请参阅

[ShapeFiltVolContext](/reference/audio/shapefiltvolcontext/shapefiltvolcontext_members)


## Related topics

- [ShapeFiltVolContext](/zh-CN/reference/audio/shapefiltvolcontext/shapefiltvolcontext_members.md)
- [GetShapeFiltVolPeakMagnitude](/zh-CN/reference/audio/shapefiltvolcontext/functions/getshapefiltvolpeakmagnitude.md)
- [GetShapeDmaMixBufferPeakMagnitude](/zh-CN/reference/audio/shapedmacontext/functions/getshapedmamixbufferpeakmagnitude.md)
- [GetShapeEqCompMixBufferPeakMagnitude](/zh-CN/reference/audio/shapeeqcompcontext/functions/getshapeeqcompmixbufferpeakmagnitude.md)
- [GetShapeSrcMixBufferPeakMagnitude0](/zh-CN/reference/audio/shapesrccontext/functions/getshapesrcmixbufferpeakmagnitude0.md)