X3DAudioCalculate 函数 (x3daudio.h)

计算与 3D 参数相关的 DSP 设置。

语法

X3DAUDIO_API_(void) X3DAudioCalculate(
  [in]      const X3DAUDIO_HANDLE   Instance,
  [in]      const X3DAUDIO_LISTENER *pListener,
  [in]      const X3DAUDIO_EMITTER  *pEmitter,
  [in]      UINT32                  Flags,
  [in, out] X3DAUDIO_DSP_SETTINGS   *pDSPSettings
);

参数

[in] Instance

3D 音频实例句柄。 调用 X3DAudioInitialize 以获取此句柄。

[in] pListener

指向表示接收点 的X3DAUDIO_LISTENER 的指针。

[in] pEmitter

指向表示声源 的X3DAUDIO_EMITTER 的指针。

[in] Flags

值	说明
X3DAUDIO_CALCULATE_MATRIX	启用矩阵系数表计算。
X3DAUDIO_CALCULATE_DELAY	启用仅立体声) (延迟时间数组计算。
X3DAUDIO_CALCULATE_LPF_DIRECT	(LPF) 直接路径系数计算启用低通滤波器。
X3DAUDIO_CALCULATE_LPF_REVERB	启用 LPF 混响路径系数计算。
X3DAUDIO_CALCULATE_REVERB	启用混响发送级别计算。
X3DAUDIO_CALCULATE_DOPPLER	启用多普勒移位因子计算。
X3DAUDIO_CALCULATE_EMITTER_ANGLE	启用发射器到侦听器的内部角度计算。
X3DAUDIO_CALCULATE_ZEROCENTER	使用静音填充中心通道。 此标志允许保留 6 声道矩阵，因此无需重新映射通道，但中心通道将无提示。 仅当同时设置了X3DAUDIO_CALCULATE_MATRIX时，此标志才有效。
X3DAUDIO_CALCULATE_REDIRECT_TO_LFE	将所有源通道的相同混合应用于 LFE) 目标通道 (低频效果。 它仅适用于没有 LFE 通道的源和具有 LFE 通道的目标的矩阵计算。 仅当同时设置了X3DAUDIO_CALCULATE_MATRIX时，此标志才有效。

[in, out] pDSPSettings

指向接收计算结果 的X3DAUDIO_DSP_SETTINGS 结构的指针。

返回值

此函数不返回值。

注解

通常，为场景中的每对发出对象和侦听器调用 X3DAudioCalculate 一次。 每次调用后，为了应用 3D 效果，应用会手动将 pDSPSettings 处的计算结果应用于XAUDIO2图。 有关详细信息，请参阅 如何：将 X3DAudio 与 XAudio2 集成。

重要 侦听器和发射器值必须有效。 浮点特殊 (NaN、QNaN、+INF、-INF) 可能会导致整个音频输出在引入到正在运行的音频图中时静音。

 

平台要求

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

Windows Phone 8.1：支持此 API。

要求

要求	值
目标平台	Windows
标头	x3daudio.h
Library	Xaudio2.lib

请参阅

函数