XAudio2Create-Funktion (xaudio2.h)

Artikel
03/13/2024

Erstellt ein neues XAudio2-Objekt und gibt einen Zeiger auf die IXAudio2-Schnittstelle zurück.

Syntax

HRESULT XAudio2Create(
  [out] IXAudio2          **ppXAudio2,
  [in]  UINT32            Flags,
  [in]  XAUDIO2_PROCESSOR XAudio2Processor
);

Parameter

[out] ppXAudio2

Wenn der Vorgang erfolgreich ist, wird ein Zeiger auf ein IXAudio2-Objekt zurückgegeben.

[in] Flags

Flags, die das Verhalten des IXAudio2-Objekts angeben. Der Wert dieses Parameters muss 0 sein.

[in] XAudio2Processor

Ein XAUDIO2_PROCESSOR typisierter Wert, der angibt, welche CPU verwendet werden soll. Wenn mehrere Bits angegeben werden, erstellt das System einen separaten Workerthread für jeden Prozessor.

XAUDIO2_PROCESSOR Standardwert ist XAUDIO2_DEFAULT_PROCESSOR.

Warnung Wenn Sie XAUDIO2_ANY_PROCESSOR angeben, verwendet das System alle Prozessoren des Geräts und erstellt, wie oben erwähnt, einen Workerthread für jeden Prozessor.

Hinweis Die Angabe eines Prozessors sollte in der Regel vermieden werden, da dies die Fähigkeit des Planers beeinträchtigen kann, Threads effektiv über Prozessoren hinweg zu planen. Übergeben Sie stattdessen den wert XAUDIO2_DEFAULT_PROCESSOR (siehe unten).

Der spezielle XAUDIO2_DEFAULT_PROCESSOR-Wert bewirkt, dass XAudio2 seinen Standardprozessor verwendet.

Rückgabewert

Gibt bei erfolgreicher Ausführung S_OK zurück, andernfalls einen Fehlercode. Beschreibungen von XAudio2-spezifischen Fehlercodes finden Sie unter XAudio2-Fehlercodes.

Hinweise

Die DirectX SDK-Versionen von XAUDIO2 ein Flag XAUDIO2_DEBUG_ENGINE unterstützt, um zwischen der Version und der "überprüften" Version auszuwählen. Dieses Flag wird in der Windows 8 Version von XAUDIO2 nicht unterstützt oder definiert.

Hinweis Keine Versionen des DirectX SDK enthalten die Importbibliothek xaudio2.lib. DirectX SDK-Versionen verwenden COM, um ein neues XAudio2-Objekt zu erstellen.

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	xaudio2.h
Bibliothek	Xaudio2.lib
DLL	Windows.Media.Audio.dll

Weitere Informationen

So wird's gemacht: Erstellen eines grundlegenden Audioverarbeitungsdiagramms

XAudio2-Funktionen

Freigeben über