共用方式為

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

另請參閱

如何：變更語音音量

使用方法：使用次混音聲音

IXAudio2Voice