IChannelAudioVolume：：GetAllVolumes 方法 (audioclient.h)

GetAllVolumes方法會擷取音訊會話中所有通道的音量層級。

語法

HRESULT GetAllVolumes(
  [in]  UINT32 dwCount,
  [out] float  *pfVolumes
);

[in] dwCount

pfVolumes陣列中的元素數目。 dwCount參數必須等於音訊會話資料流程格式的通道數目。若要取得通道數目，請呼叫 IChannelAudioVolume：：GetChannelCount 方法。

[out] pfVolumes

音訊會話中通道的音量層級陣列指標。此參數指向呼叫端配置的 float 陣列，此方法會寫入個別通道的磁片區層級。磁片區層級的範圍是 0.0 到 1.0。

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

傳回碼	Description
E_INVALIDARG	參數 dwCount 不等於音訊會話資料流程格式的通道數目。
E_POINTER	參數 pfVolumes 為 Null。
AUDCLNT_E_DEVICE_INVALIDATED	音訊端點裝置已解除叢集，或音訊硬體或相關聯的硬體資源已重新設定、停用、移除，否則無法使用。
AUDCLNT_E_SERVICE_NOT_RUNNING	Windows 音訊服務未執行。

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