IChannelAudioVolume：：GetChannelVolume 方法 (audioclient.h)

GetChannelVolume方法會擷取音訊會話中指定通道的音量層級。

語法

HRESULT GetChannelVolume(
  [in]  UINT32 dwIndex,
  [out] float  *pfLevel
);

[in] dwIndex

通道號碼。如果音訊會話的資料流程格式有 N 個通道，則通道編號為 0 到 N– 1。若要取得通道數目，請呼叫 IChannelAudioVolume：：GetChannelCount 方法。

[out] pfLevel

浮點數變數的指標，方法會將指定通道的磁片區層級寫入其中。磁片區層級的範圍是 0.0 到 1.0。

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

傳回碼	Description
E_INVALIDARG	參數 dwIndex 設定為不正確通道號碼。
E_POINTER	參數 pfLevel 為 Null。
AUDCLNT_E_DEVICE_INVALIDATED	音訊端點裝置已解除叢集，或音訊硬體或相關聯的硬體資源已重新設定、停用、移除，否則無法使用。
AUDCLNT_E_SERVICE_NOT_RUNNING	Windows 音訊服務未執行。

用戶端可以呼叫 IChannelAudioVolume：：SetAllVolumes 或 IChannelAudioVolume：：SetChannelVolume 方法，在音訊會話中設定每個通道音量層級。