IAudioMeterInformation：：GetPeakValue 方法 (endpointvolume.h)

GetPeakValue 方法获取音频流中声道的峰值样本值。

语法

HRESULT GetPeakValue(
  [out] float *pfPeak
);

[out] pfPeak

指向浮点变量的指针，方法在该变量中写入音频流的峰值样本值。峰值是规范化范围从 0.0 到 1.0 的数字。

如果该方法成功，则它会返回 S_OK。如果失败，可能的返回代码包括但不限于下表中显示的值。

返回代码	说明
E_POINTER	参数 pfPeak 为 NULL。

此方法检索流中所有通道中记录的峰值样本值。每个通道的峰值记录在一个设备周期内，并在后续设备期间可用。因此，此方法始终检索在上一个设备期间记录的峰值。若要获取设备周期，请调用 IAudioClient：：GetDevicePeriod 方法。

有关使用 GetPeakValue 方法的代码示例，请参阅峰值计量。