Freigeben über

XAudio2-Debugfunktionen

  • Artikel

Die Debugversion des XAudio2-Moduls überprüft Parameter und stellt detaillierte Warn- und Fehlermeldungen bereit.

Festlegen der Debugprotokollierungsebene zur Laufzeit

Sie können die von XAudio2 angezeigte Debuginformationsebene jederzeit festlegen, indem Sie eine XAUDIO2_DEBUG_CONFIGURATION-Struktur mit den Flags für die gewünschte Protokollierungsebene ausfüllen und die Struktur dann an die IXAudio2::SetDebugConfiguration-Methode übergeben. An die IXAudio2::SetDebugConfiguration-Methode übergebene Werte überschreiben immer alle Standardwerte, die in der Windows-Registrierung festgelegt wurden.

Debugunterstützung

Die Debugfunktionen sind für XAUDIO2 in Windows 8.x, Windows 10, Windows 11 und bei Verwendung des XAudio2Redist-Pakets immer verfügbar.

Für die älteren DirectX SDK-Versionen von XAUDIO2 müssen Sie beim Erstellen des XAUDIO2-Objekts mit XAudio2CreateXAUDIO2_DEBUG_ENGINE verwenden, und das System muss die DirectX SDK Developer Runtime installiert haben, damit das Debuggen unterstützt wird.

Aktivieren der Ereignisablaufverfolgung für Windows (ETW) für XAudio2

Ab XAudio 2.8 werden alle Debuginformationen über ETW protokolliert. Führen Sie die folgenden Schritte aus, um die Protokollierung dieser Ereignisse zu aktivieren:

  1. Suchen Sie auf Ihrem lokalen System nach "Ereignisanzeige", und führen Sie diese Anwendung aus.
  2. Wählen Sie auf der Menüleiste Anzeigen aus, und legen Sie das Häkchen auf Analyse- und Debugprotokolle anzeigen fest.
  3. Wählen Sie in der Strukturansicht Anwendungs- und Dienstprotokolle / Microsoft / Windows / XAudio2 aus.
  4. Klicken Sie mit der rechten Maustaste auf die Microsoft Windows XAudio2-Debugprotokollierung , und wählen Sie "Eigenschaften" aus.
  5. Klicken Sie auf das Kontrollkästchen "Protokoll aktivieren", und klicken Sie auf "OK". Sie können optional den Protokollspeicherort ändern, der standardmäßig auf lautet %SystemRoot%\System32\Winevt\Logs\Microsoft-Windows-XAudio2%4Debug.etl.

Führen Sie Ihre Szenarien wie gewohnt aus. Wenn Sie die zuletzt verwendete Aktivität anzeigen möchten, öffnen Sie die ETL-Protokolldatei, und suchen Sie nach Ereignissen. Es gibt eine Reihe von Tools, die Sie verwenden können, einschließlich der Ereignisanzeige über "Gespeichertes Protokoll öffnen..." im Aktionsbereich.

Weitere Informationen finden Sie unter Ereignisablaufverfolgung.

Debugmöglichkeiten

XAudio2-Programmierreferenz