共用方式為


IAudioMeterInformation::GetPeakValue 方法 (endpointvolume.h)

GetPeakValue方法會取得音訊資料流程中通道的尖峰樣本值。

語法

HRESULT GetPeakValue(
  [out] float *pfPeak
);

參數

[out] pfPeak

數變數的指標,此方法會寫入音訊資料流程的尖峰樣本值。 尖峰值是標準化範圍從 0.0 到 1.0 的數位。

傳回值

如果方法成功,它會傳回 S_OK。 如果失敗,可能的傳回碼包括,但不限於下表所示的值。

傳回碼 描述
E_POINTER
參數 pfPeakNull

備註

這個方法會擷取在資料流程中所有通道上記錄的尖峰樣本值。 每個通道的尖峰值會記錄在一個裝置期間內,並在後續的裝置期間提供。 因此,這個方法一律會擷取在上一個裝置期間記錄的尖峰值。 若要取得裝置期間,請呼叫 IAudioClient::GetDevicePeriod 方法。

如需使用 GetPeakValue 方法的程式碼範例,請參閱 尖峰計量

需求

   
最低支援的用戶端 Windows Vista [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 endpointvolume.h

另請參閱

IAudioClient::GetDevicePeriod

IAudioMeterInformation 介面