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

# GetShapeEqCompPeakMagnitude

> GetShapeEqCompPeakMagnitude

# GetShapeEqCompPeakMagnitude

获取峰值幅度。

## 语法

```cpp theme={null}
float GetShapeEqCompPeakMagnitude(  
         const SHAPE_EQCOMP_CONTEXT* context  
)  
```

### 参数

*context*   \_In\_\
类型：[SHAPE\_EQCOMP\_CONTEXT\*](https://docs.xbox.com/zh-CN/reference/audio/shapeeqcompcontext/structs/shape_eqcomp_context.md)

指向 `SHAPE_EQCOMP_CONTEXT` 对象的指针。

### 返回值

类型：float

峰值幅度。

## 备注

每个硬件模块维护两个 4 位数值，用于表示硬件模块输出的幅度。幅度是通过确定音频帧期间的峰值输出并统计该峰值绝对值的前导零数量来计算的。其中一个 4 位数值保持持续的峰值幅度，另一个由硬件每个音频帧重置。

有关详细信息，请参阅 [SHAPE 概述](https://docs.xbox.com/zh-CN/build/console-features/audio/overviews/shape-overview.md) 中的 [溢出、幅度和饱和](https://docs.xbox.com/zh-CN/build/console-features/audio/overviews/shape-overview.md#ID4ELAAC)。

## 要求

**头文件：** shapeeqcompcontext.h

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

## 另请参阅

[GetShapeEqCompMixBufferPeakMagnitude](https://docs.xbox.com/zh-CN/reference/audio/shapeeqcompcontext/functions/getshapeeqcompmixbufferpeakmagnitude.md)\
[ShapeEqCompContext](https://docs.xbox.com/zh-CN/reference/audio/shapeeqcompcontext/shapeeqcompcontext_members.md)


## Related topics

- [GetShapeEqCompMixBufferPeakMagnitude](https://docs.xbox.com/zh-CN/reference/audio/shapeeqcompcontext/functions/getshapeeqcompmixbufferpeakmagnitude.md)
- [GetShapeEqCompInternalSaturate](https://docs.xbox.com/zh-CN/reference/audio/shapeeqcompcontext/functions/getshapeeqcompinternalsaturate.md)
- [ShapeEqCompContext](https://docs.xbox.com/zh-CN/reference/audio/shapeeqcompcontext/shapeeqcompcontext_members.md)
- [GetShapeDmaPeakMagnitude](https://docs.xbox.com/zh-CN/reference/audio/shapedmacontext/functions/getshapedmapeakmagnitude.md)
- [GetShapeFiltVolPeakMagnitude](https://docs.xbox.com/zh-CN/reference/audio/shapefiltvolcontext/functions/getshapefiltvolpeakmagnitude.md)