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

值	Description
X3DAUDIO_CALCULATE_MATRIX	啟用矩陣係數數據表計算。
X3DAUDIO_CALCULATE_DELAY	只啟用延遲時間數位計算， (立體聲) 。
X3DAUDIO_CALCULATE_LPF_DIRECT	啟用低傳遞篩選 (LPF) 直接路徑係數計算。
X3DAUDIO_CALCULATE_LPF_REVERB	啟用 LPF 殘響路徑係數計算。
X3DAUDIO_CALCULATE_REVERB	啟用殘響傳送層級計算。
X3DAUDIO_CALCULATE_DOPPLER	啟用 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
程式庫	Xaudio2.lib

請參閱

函式