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 を 1 回呼び出します。 各呼び出しの後、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

関連項目

関数