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

# GetShapeEqCompMixBufferPeakMagnitude

> GetShapeEqCompMixBufferPeakMagnitude

# GetShapeEqCompMixBufferPeakMagnitude

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

## 语法

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

### 参数

*context*   \_In\_\
类型：[SHAPE\_EQCOMP\_CONTEXT\*](/reference/audio/shapeeqcompcontext/structs/shape_eqcomp_context)

指向 `SHAPE_EQCOMP_CONTEXT` 对象的指针。

### 返回值

类型：float

峰值幅度。

## 备注

除了监视每个硬件模块的峰值幅度外，还会维护混合缓冲区的峰值幅度。当某个硬件模块的输出被加到混合缓冲区时，峰值幅度会以同样的方式（通过统计前导零的数量）进行计算。每个硬件模块状态都额外维护一对 4 位的峰值幅度值。这些值表示在硬件模块的输出累加到混合缓冲区之后混合缓冲区的峰值幅度。其中一个 4 位数值表示持续的峰值幅度，另一个每个音频帧都会更新。虽然表示的是混合缓冲区的状态，但峰值幅度值会保存在可扩展硬件音频处理引擎 (SHAPE) 模块的上下文中。

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

## 要求

**头文件：** shapeeqcompcontext.h

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

## 另请参阅

[GetShapeEqCompPeakMagnitude](/reference/audio/shapeeqcompcontext/functions/getshapeeqcomppeakmagnitude)\
[ShapeEqCompContext](/reference/audio/shapeeqcompcontext/shapeeqcompcontext_members)