IAudioEndpointVolume：：GetMasterVolumeLevelScalar 方法 (endpointvolume.h)

GetMasterVolumeLevelScalar 方法會取得進入或離開音訊端點裝置之音訊數據流的主要音量層級。音量層級會以標準化的音頻磁帶值表示，範圍從0.0到1.0。

語法

HRESULT GetMasterVolumeLevelScalar(
  [out] float *pfLevel
);

[out] pfLevel

主要磁碟區層級的指標。此參數指向方法寫入磁碟區層級的 float 變數。層級會以 0.0 到 1.0 範圍中的正規化值表示。

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

傳回碼	Description
E_POINTER	參數 pfLevel 為 NULL。

磁碟區層級會正規化為從0.0到1.0的範圍，其中0.0是最小磁碟區層級，而1.0是最大層級。在此範圍內，正規化音量層級與訊號幅度衰減的關聯性是由非線性、音頻磁帶曲線所描述。請注意，曲線的形狀可能會在未來的 Windows 版本中變更。如需音頻磁帶曲線的詳細資訊，請參閱音頻磁帶磁碟區控件。

此方法所擷取的標準化磁碟區層級適合用來代表應用程式視窗和螢幕上顯示器的音量控制元件位置。

如需呼叫 GetMasterVolumeLevelScalar 的程式代碼範例，請參閱端點磁碟區控件。

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