(audioclient.h) IAudioStreamVolume：：SetAllVolumes 方法

SetAllVolumes 方法會設定音訊數據流中所有通道的個別音量層級。

語法

HRESULT SetAllVolumes(
  [in] UINT32      dwCount,
  [in] const float *pfVolumes
);

[in] dwCount

pfVolumes 陣列中的項目數目。此參數必須等於數據流格式的通道數目。若要取得通道數目，請呼叫 IAudioStreamVolume：：GetChannelCount 方法。

[in] pfVolumes

音訊數據流中信道音量層級數位的指標。 pfVolumes 陣列中的項目數目是由 dwCount 參數所指定。呼叫端會將每個通道的磁碟區層級寫入至索引符合通道號碼的陣列元素。如果數據流格式有 N 個通道，通道會從 0 編號為 N– 1。有效的磁碟區層級介於 0.0 到 1.0 的範圍內。

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

傳回碼	Description
E_INVALIDARG	參數 dwCount 不等於數據流中的通道數目，或 pfVolumes 陣列元素的值不在 0.0 到 1.0 的範圍內。
E_POINTER	參數 pfVolumes 為 NULL。
AUDCLNT_E_DEVICE_INVALIDATED	音訊端點裝置已解除叢集，或音訊硬體或相關聯的硬體資源已重新設定、停用、移除或無法使用。
AUDCLNT_E_SERVICE_NOT_RUNNING	Windows 音訊服務未執行。