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 |