IAudioEndpointVolume::GetChannelVolumeLevelScalar 方法 (endpointvolume.h)

GetChannelVolumeLevelScalar方法會取得輸入或離開音訊端點裝置之指定音訊資料流程之指定通道的正規化音訊磁帶音量層級。

語法

HRESULT GetChannelVolumeLevelScalar(
  [in]  UINT  nChannel,
  [out] float *pfLevel
);

參數

[in] nChannel

通道號碼。 如果音訊資料流程包含 n 個通道,則通道編號為 0 到 n– 1。 若要取得通道數目,請呼叫 IAudioEndpointVolume::GetChannelCount 方法。

[out] pfLevel

方法寫入磁片區層級的 float 變數指標。 層級是以 0.0 到 1.0 範圍內的標準化值表示。

傳回值

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

傳回碼 描述
E_INVALIDARG
參數 nChannel 大於或等於資料流程中的通道數目。
E_POINTER
參數 pfLevelNull

備註

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

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

需求

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

另請參閱

IAudioEndpointVolume 介面

IAudioEndpointVolume::GetChannelCount