共用方式為


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

另請參閱

IXAudio2Voice