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

# GetShapeFiltVolPeakMagnitude

> GetShapeFiltVolPeakMagnitude

# GetShapeFiltVolPeakMagnitude

获取峰值幅度。

## 语法

```cpp theme={null}
float GetShapeFiltVolPeakMagnitude(  
         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 概述](/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)
- [GetShapeFiltVolMixBufferPeakMagnitude](/zh-CN/reference/audio/shapefiltvolcontext/functions/getshapefiltvolmixbufferpeakmagnitude.md)
- [GetShapeDmaPeakMagnitude](/zh-CN/reference/audio/shapedmacontext/functions/getshapedmapeakmagnitude.md)
- [GetShapeEqCompPeakMagnitude](/zh-CN/reference/audio/shapeeqcompcontext/functions/getshapeeqcomppeakmagnitude.md)
- [GetShapeDmaMixBufferPeakMagnitude](/zh-CN/reference/audio/shapedmacontext/functions/getshapedmamixbufferpeakmagnitude.md)