Freigeben über

XAudio2Create-Funktion (xaudio2.h)

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

Die 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 sind, erstellt das System für jeden Prozessor einen separaten Arbeitsthread.

XAUDIO2_PROCESSOR Standardwert ist XAUDIO2_DEFAULT_PROCESSOR.

Warnung Wenn Sie XAUDIO2_ANY_PROCESSOR angeben, verwendet das System alle Prozessoren des Geräts, und wie oben erwähnt, erstellen Sie einen Workerthread für jeden Prozessor.
 
Anmerkung Die Angabe eines Prozessors sollte im Allgemeinen vermieden werden, da dies die Fähigkeit des Schedulers 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 S_OK bei erfolgreicher Ausführung einen Fehlercode zurück. Beschreibungen zu XAudio2-Spezifischen Fehlercodes finden Sie unter XAudio2-Fehlercodes .

Bemerkungen

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

Anmerkung Keine Versionen des DirectX SDK enthalten die xaudio2.lib-Importbibliothek. DirectX SDK-Versionen verwenden COM zum Erstellen eines neuen XAudio2-Objekts .
 

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

Siehe auch

Gewusst wie: Erstellen eines einfachen Audioverarbeitungsdiagramms

XAudio2-Funktionen

  • Last updated on