XAudio2 Debugging Facilities

Die Debugversion der XAudio2-Engine überprüft Parameter und stellt detaillierte Warnungen und Fehlermeldungen bereit.

Festlegen des Debugprotokolliergrads zur Laufzeit

Sie können die Von XAudio2 angezeigten Debuginformationen jederzeit festlegen, indem Sie eine XAUDIO2 _ DEBUG _ CONFIGURATION-Struktur mit den Flags für den gewünschten Protokolliergrad ausfüllen und dann die Struktur an die IXAudio2::SetDebugConfiguration-Methode übergeben. An die IXAudio2::SetDebugConfiguration-Methode übergebene Werte überschreiben immer alle Standardwerte, die in der registrierung Windows festgelegt wurden.

Debugunterstützung

Die Debugmöglichkeiten 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 die XAUDIO2-DEBUG-ENGINE _ _ verwenden, wenn Sie das XAUDIO2-Objekt mit XAudio2Create erstellen, und auf dem System muss die DirectX SDK Developer Runtime installiert sein, damit das Debuggen unterstützt wird.

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

Mit XAudio 2.8 oder höher werden alle Debuginformationen über ETW protokolliert. Um die Protokollierung dieser Ereignisse zu aktivieren, verwenden Sie die folgenden Schritte:

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

Führen Sie Ihre Szenarien wie gewohnt aus, und wenn Sie die aktuelle 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.

Debuggen von Einrichtungen

XAudio2-Programmierreferenz