IAudioStreamVolume：：GetAllVolumes 方法 (audioclient.h)

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

語法

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

[in] dwCount

pfVolumes 陣列中的元素數目。 dwCount 參數必須等於數據流格式的通道數目。若要取得通道數目，請呼叫 IAudioStreamVolume：：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 音訊服務未執行。

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