IAudioEndpointVolume::GetChannelVolumeLevel 方法 (endpointvolume.h)
GetChannelVolumeLevel方法會取得輸入或離開音訊端點裝置之音訊資料流程中指定通道的音量層級,以分貝為單位。
語法
HRESULT GetChannelVolumeLevel(
[in] UINT nChannel,
[out] float *pfLevelDB
);
參數
[in] nChannel
通道號碼。 如果音訊串流有 n 個通道,則通道會從 0 編號為 n– 1。 若要取得資料流程中的通道數目,請呼叫 IAudioEndpointVolume::GetChannelCount 方法。
[out] pfLevelDB
浮點數變數的指標,方法會將磁片區層級以分貝為單位寫入其中。 若要取得從這個方法取得的磁片區層級範圍,請呼叫 IAudioEndpointVolume::GetVolumeRange 方法。
傳回值
如果方法成功,它會傳回 S_OK。 如果失敗,可能的傳回碼包括但不限於下表所示的值。
傳回碼 | 描述 |
---|---|
|
參數 nChannel 大於或等於資料流程中的通道數目。 |
|
參數 pfLevelDB 為 Null。 |
需求
最低支援的用戶端 | Windows Vista [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2008 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | endpointvolume.h |