XAUDIO2_VOICE_SENDS 结构 (xaudio2.h)

定义一组语音以从单个输出语音接收数据。

语法

typedef struct XAUDIO2_VOICE_SENDS {
  UINT32                  SendCount;
  XAUDIO2_SEND_DESCRIPTOR *pSends;
} XAUDIO2_VOICE_SENDS;

成员

SendCount

要接收语音输出的语音数。 OutputCount 值为 0 表示语音不应将输出发送到任何语音。

pSends

描述目标语音以及发送到语音时应使用的筛选器的 XAUDIO2_SEND_DESCRIPTOR 结构的数组。 此数组应包含 SendCount 元素。 如果 SendCount 为 0 pSends 应为 NULL。 请注意, pSends 不能多次包含同一语音。

注解

如果 pSends 不是 NULL,则其所有元素都必须为非 NULL。 若要将输出发送到默认主语音,请调用 IXAudio2Voice::SetOutputVoices ,并将 pSendList 参数设置为 NULL。

SendCount 设置为 0 对于某些效果(如音量计或文件编写器)非常有用,这些效果不会生成任何要传递给另一语音的音频输出。

如果需要,语音将执行单个采样率转换,从语音的输入采样率到语音输出语音的输入采样率。 由于将只执行一个采样率转换,因此所有语音的输出语音必须具有相同的输入采样率。 如果语音的输入采样率及其输出语音相同,则不执行采样率转换。

平台要求

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

要求

   
标头 xaudio2.h

另请参阅

如何:更改语音音量

如何:使用提交语音

IXAudio2::CreateSourceVoice

IXAudio2::CreateSubmixVoice

IXAudio2Voice::SetOutputVoices

XAudio 结构

XAudio2 采样率转换