IXAudio2Voice::SetOutputFilterParameters 方法 (xaudio2.h)

设置其中一个语音发送的筛选器参数。

语法

\\HRESULT SetOutputFilterParameters(
  [in] IXAudio2Voice                   *pDestinationVoice,
  [in] const XAUDIO2_FILTER_PARAMETERS *pParameters,
  [in] UINT32                          OperationSet
);

参数

[in] pDestinationVoice

指向将设置其筛选器参数的发送的目标语音的 IXAudio2Voice 指针。

[in] pParameters

指向包含筛选器信息的 XAUDIO2_FILTER_PARAMETERS 结构的指针。

[in] OperationSet

将此调用标识为延迟批处理的一部分。 有关详细信息,请参阅 XAudio2 操作集 概述。

返回值

如果成功,则返回S_OK,否则返回错误代码。 有关错误代码的说明,请参阅 XAudio2 错误代码。

注解

如果未使用 XAUDIO2_SEND_USEFILTER 标志创建发送,则 SetOutputFilterParameters 将失败。 此方法仅在属于源语音和子混合语音的发送上可用,对主语音的发送没有影响。

注意IXAudio2Voice::GetOutputFilterParameters 始终返回此发送的实际当前筛选器参数。 但是,这些参数可能与最新的 IXAudio2Voice::SetOutputFilterParameters 调用设置的参数不匹配:实际参数仅在 IXAudio2Voice::SetOutputFilterParameters 调用 (之后或在相应的 IXAudio2::CommitChanges 调用之后的音频引擎下次运行时更改, 如果调用 了 IXAudio2Voice::SetOutputFilterParameters 并) 延迟的操作 ID。
 

平台要求

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

要求

   
目标平台 Windows
标头 xaudio2.h

另请参阅

IXAudio2Voice