IXAudio2Voice::GetChannelVolumes 方法 (xaudio2.h)
傳回每個通道的語音音量層級。
語法
\\ void GetChannelVolumes(
[in] UINT32 Channels,
[out] float *pVolumes
);
參數
[in] Channels
確認語音的通道計數。
[out] pVolumes
傳回語音中每個通道的目前音量層級。 數位至少必須有 Channels 元素。 如需磁碟區層級的詳細資訊,請參閱。
傳回值
這個方法不會傳回值。
備註
套用效果鏈結之後,會套用這些設定。 這個方法僅適用於來源和副混音,因為主控語音不會為每個通道指定音量。
磁碟區層級會以浮點幅度乘數表示,介於 -2到 2⁴ 之間,最大增益為 144.5 dB。 1 的音量表示沒有衰減或增益,0 表示無聲,而負層級可用來反轉音訊的階段。 如需音量控制的其他資訊,請參閱 XAudio2 音量和音調控制 。
注意GetChannelVolumes 一律會傳回最近由 IXAudio2Voice::SetChannelVolumes 設定的磁碟區層級。 不過,這些值可能實際上尚未生效:只有在音訊引擎在 IXAudio2Voice::SetChannelVolumes 呼叫 (或對應的 IXAudio2::CommitChanges 呼叫之後才會生效,如果 IXAudio2Voice::SetChannelVolumes 是以延遲的作業標識符呼叫) 。
平臺需求
Windows 10 (XAudio2.9) ;Windows 8,Windows Phone 8 (XAudio 2.8) ;DirectX SDK (XAudio 2.7)規格需求
需求 | 值 |
---|---|
目標平台 | Windows |
標頭 | xaudio2.h |