次の方法で共有


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

関連項目

関数