Freigeben über


XAudio2-Versionen

XAudio2 ist eine plattformübergreifende API, die für die Verwendung auf Xbox 360 sowie Windows-Versionen, darunter Windows XP, Windows Vista, Windows 7 und Windows 8, ausgeliefert wurde. Auf der Xbox 360 wird XAudio2 als statische Bibliothek ausgeliefert, die in die ausführbare Datei des Hauptspiels kompiliert wird. Unter Windows wird XAudio2 als DLL (Dynamic Link Library) bereitgestellt, die in den Systemordnern des Betriebssystems installiert ist.

XAudio 2.9 (Windows 10 und weiterverteilbar für Windows 7 und Windows 8.x)

XAudio2, Version 2.9, wird als Teil von Windows 10, XAUDIO2_9.DLL, zusammen mit XAudio 2.8 ausgeliefert, um ältere Anwendungen zu unterstützen. Eine weiterverteilbare Version von XAudio 2.9 ist auch für Windows 7 SP1, Windows 8 und Windows 8.1 verfügbar.

XAudio2.9 wurde mit den folgenden Änderungen aktualisiert:

  • Neue Erstellungskennzeichnungen: XAUDIO2_DEBUG_ENGINE, XAUDIO2_STOP_ENGINE_WHEN_IDLE, XAUDIO2_1024_QUANTUM
  • Die xWMA-Unterstützung ist in dieser Version von XAudio2 verfügbar.
  • Die Funktion CreateHrtfApo wird in der Windows 10-Version von XAudio 2.9 unterstützt.
  • XAUDIO2FX_REVERB_PARAMETERS enthält jetzt den Wert SideDelay für 7.1-Systeme.
  • Die Funktion ReverbConvertI3DL2ToNative enthält nun den booleschen Parameter sevenDotOneReverb, der 7.1-Hall ermöglicht.

XAudio 2.8 (Windows 8.x)

XAudio2, Version 2.8, wird heute als Systemkomponente in Windows 8, XAUDIO2_8.DLL ausgeliefert. Sie ist im „Posteingang“ verfügbar und erfordert keine erneute Verteilung mit einer App. Es wird empfohlen, das Windows Software Development Kit (SDK) für Windows 8 für die Entwicklung für XAudio2 zu verwenden. Das Windows SDK für Windows 8 enthält die erforderliche Header- und Importbibliothek zum statischen Verknüpfen mit XAUDIO2_8.DLL.

XAudio2 2.8 wurde mit den folgenden Änderungen aktualisiert:

  • Diese Version unterstützt die Entwicklung von UWP-Apps. Die XAudio2-API kann in C++/DirectX-UWP-Apps verwendet werden.
  • XAudio2Create ist ein flacher Win32-API-Aufruf und erstellt keine XAudio2 CLSID mehr. Die Unterstützung für die Instanziierung von XAudio2 durch CoCreateInstance wurde entfernt.
  • Die Initialize-Funktion wird nun implizit vom Erstellungsprozess aufgerufen und wurde aus der IXAudio2-Schnittstelle entfernt.
  • Die Funktionalität der Geräteaufzählung wurde aus XAudio2 entfernt. Die Funktionen „GetDeviceDetails“ und „GetDeviceCount“ wurden aus der IXAudio2-Schnittstelle entfernt. Apps, die auf anderen Audiogeräten im System rendern möchten, müssen CreateMasteringVoice eine Gerätekennungszeichenfolge anstelle eines Geräteindex übergeben. Das standardmäßige Audiowiedergabegerät kann weiterhin ohne Enumeration erstellt werden.
  • IXAudio2MasteringVoice verfügt über eine hinzugefügte Funktion IXAudio2MasteringVoice::GetChannelMask, für die das Kanalformat für das Zielausgabegerät zurückgegeben wird.
  • Die Bibliotheken X3DAudio und XAPOFX werden in XAudio2 zusammengeführt. Der App-Code verwendet weiterhin separate Header, X3DAUDIO.H und XPOFX.H, ist jetzt aber mit einer einzigen Importbibliothek, XAUDIO2_8.LIB, verknüpft.
  • xWMA-Unterstützung ist in dieser Version von XAudio2 nicht verfügbar. xWMA wird beim Aufrufen von CreateSourceVoice nicht als Audiopufferformat unterstützt. Wir empfehlen jetzt das Media Foundation Source Reader-Objekt zum Dekodieren einer Vielzahl von Medienformaten in PCM-Puffer im Arbeitsspeicher.
  • CreateFX akzeptiert jetzt vier Parameter anstelle von zwei. Die neueren Parameter geben die anfänglichen Daten als Teil der XAPOFX-Erstellung an.

XAudio 2.7 und frühere Versionen (Windows 7)

Alle vorherigen Versionen von XAudio2 für die Verwendung in Apps wurden als verteilbare DLLs im DirectX SDK bereitgestellt. Die erste Version von XAudio2, XAudio2 2.0, wurde in der Version vom März 2008 des DirectX SDK ausgeliefert. Die letzte im DirectX SDK ausgelieferte Version war XAudio2 2.7, verfügbar in der letzten Version des DirectX SDK im Juni 2010.

Das alte DirectX SDK ist aufgrund der Außerdienststellung aller mit SHA-1 signierten Inhalte nicht mehr bei Microsoft Downloads verfügbar. Juni 2010 war die End-of-Life-Version.

Frühere Versionen von XAudio2 können nicht zum Erstellen von Windows-Runtime-(WinRT-)Apps für Windows 8 verwendet werden.

Erste Schritte

XAudio2-Schlüsselkonzepte

Entwicklerhandbuch für die weiterverteilbare Version von XAudio 2.9