X3DAudioCalculate-Funktion (x3daudio.h)

Artikel
03/04/2024

Berechnet DSP-Einstellungen in Bezug auf 3D-Parameter.

Syntax

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
);

Parameter

[in] Instance

3D-Audio instance Handle. Rufen Sie X3DAudioInitialize auf, um dieses Handle zu erhalten.

[in] pListener

Zeiger auf eine X3DAUDIO_LISTENER , die den Empfangspunkt darstellt.

[in] pEmitter

Zeiger auf eine X3DAUDIO_EMITTER , die die Soundquelle darstellt.

[in] Flags

Wert	BESCHREIBUNG
X3DAUDIO_CALCULATE_MATRIX	Aktiviert die Berechnung der Matrixkoeffiziententabelle.
X3DAUDIO_CALCULATE_DELAY	Ermöglicht die Berechnung von Verzögerungszeitarrays (nur Stereo).
X3DAUDIO_CALCULATE_LPF_DIRECT	Ermöglicht die Berechnung des Direct-Path-Koeffizienten für Den Tiefpassfilter (Low Pass Filter, LPF).
X3DAUDIO_CALCULATE_LPF_REVERB	Aktiviert die Berechnung des LPF-Hallpfadkoeffizienten.
X3DAUDIO_CALCULATE_REVERB	Aktiviert die Berechnung des Hallsendegrads.
X3DAUDIO_CALCULATE_DOPPLER	Aktiviert die Berechnung des Doppler-Schichtfaktors.
X3DAUDIO_CALCULATE_EMITTER_ANGLE	Ermöglicht die Berechnung des Innenwinkels von Emitter zu Listener.
X3DAUDIO_CALCULATE_ZEROCENTER	Füllt den mittleren Kanal mit Stille aus. Mit diesem Flag können Sie eine 6-Kanal-Matrix beibehalten, sodass Sie die Kanäle nicht neu zuordnen müssen, aber der mittlere Kanal wird im Hintergrund ausgeführt. Dieses Flag ist nur gültig, wenn Sie auch X3DAUDIO_CALCULATE_MATRIX festlegen.
X3DAUDIO_CALCULATE_REDIRECT_TO_LFE	Wendet eine gleiche Mischung aller Quellkanäle auf einen LFE-Zielkanal (Low Frequency Effect, Low Frequency Effect) an. Sie gilt nur für Matrixberechnungen mit einer Quelle ohne LFE-Kanal und einem Ziel, das über einen LFE-Kanal verfügt. Dieses Flag ist nur gültig, wenn Sie auch X3DAUDIO_CALCULATE_MATRIX festlegen.

[in, out] pDSPSettings

Zeiger auf eine X3DAUDIO_DSP_SETTINGS Struktur, die die Berechnungsergebnisse empfängt.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Bemerkungen

In der Regel rufen Sie X3DAudioCalculate einmal für jedes Paar von ausgebenden Objekten und Listenern in der Szene auf. Nach jedem Aufruf wendet die App die Berechnungsergebnisse bei pDSPSettings manuell auf das XAUDIO2 Graph an, um die 3D-Effekte anzuwenden. Weitere Informationen finden Sie unter Vorgehensweise: Integrieren von X3DAudio in XAudio2.

Wichtig Der Listener und der Emitterwert müssen gültig sein. Gleitkomma-Specials (NaN, QNaN, +INF, -INF) können dazu führen, dass die gesamte Audioausgabe stumm läuft, wenn sie in ein laufendes Audiodiagramm eingefügt wird.

Plattformanforderungen

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

Windows Phone 8.1: Diese API wird unterstützt.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	x3daudio.h
Bibliothek	Xaudio2.lib

Siehe auch

Funktionen