IXAudio2Voice：：SetVolume 方法 (xaudio2.h)
設定語音的整體音量層級。
語法
\\HRESULT SetVolume(
[in] float Volume,
[in] UINT32 OperationSet
);
參數
[in] Volume
要使用的整體磁碟區層級。 如需磁碟區層級的詳細資訊，請參閱。
[in] OperationSet
將此呼叫識別為延遲批次的一部分。 如需詳細資訊，請參閱 XAudio2 作業集 概觀。
傳回值
如果成功，則傳回S_OK，否則傳回錯誤碼。 如需錯誤碼的描述，請參閱 XAudio2 錯誤碼 。
備註
SetVolume 可控制語音的主要輸入音量層級。 視語音類型而定，主要音量層級會在不同的時間套用。 對於副混音和主音，音量層級會在套用語音的內建篩選和效果鏈之前套用。 對於來源語音，主要音量層級會在套用語音篩選和效果鏈結之後套用。
磁碟區層級會以 -XAUDIO2_MAX_VOLUME_LEVEL 與 XAUDIO2_MAX_VOLUME_LEVEL (-2ー⁴ 到 2ー⁴) 之間的浮點幅度乘數表示，最大增益為 144.5 dB。 1.0 的音量層級表示沒有衰減或增益，而0表示無聲。 負數等級可用來反轉音訊的階段。 如需音量控制的其他資訊，請參閱 XAudio2 音量和音調控制 。
注意IXAudio2Voice：：GetVolume 一律會傳回 最近由 IXAudio2Voice：：SetVolume 設定的磁碟區。 不過，它可能實際上並未生效：只有在 IXAudio2Voice：：SetVolume 呼叫 (或對應的 IXAudio2：：CommitChanges 呼叫之後才會生效，如果 IXAudio2Voice：：SetVolume 是以延遲的作業標識符呼叫) 。
平臺需求
Windows 10 (XAudio2.9) ;Windows 8，Windows Phone 8 (XAudio 2.8) ;DirectX SDK (XAudio 2.7)規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Windows |
| 標頭 | xaudio2.h |