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 调用 IXAudio2Voice::SetChannelVolumes )的下一次运行时生效,) 。
 

平台要求

Windows 10 (XAudio2.9) ;Windows 8,Windows Phone 8 (XAudio 2.8) ;DirectX SDK (XAudio 2.7)

要求

要求
目标平台 Windows
标头 xaudio2.h

另请参阅

IXAudio2Voice