XAUDIO2_DEBUG_CONFIGURATION-Struktur (xaudio2.h)

Artikel
03/04/2024

Enthält die neue globale Debugkonfiguration für XAudio2. Wird mit der Funktion SetDebugConfiguration verwendet.

Syntax

typedef struct XAUDIO2_DEBUG_CONFIGURATION {
  UINT32 TraceMask;
  UINT32 BreakMask;
  BOOL   LogThreadID;
  BOOL   LogFileline;
  BOOL   LogFunctionName;
  BOOL   LogTiming;
} XAUDIO2_DEBUG_CONFIGURATION;

Member

TraceMask

Bitmaske von aktivierten Debugnachrichtentypen. Kann mindestens 0 der folgenden Elemente sein:

Wert	BESCHREIBUNG
XAUDIO2_LOG_ERRORS	Protokollieren sie Fehlermeldungen.
XAUDIO2_LOG_WARNINGS	Protokollieren sie Warnmeldungen. Hinweis Durch aktivieren XAUDIO2_LOG_WARNINGS wird auch XAUDIO2_LOG_ERRORS aktiviert.
XAUDIO2_LOG_INFO	Protokollieren von Informationsmeldungen.
XAUDIO2_LOG_DETAIL	Protokollieren Sie detaillierte Informationsmeldungen. Hinweis Durch aktivieren XAUDIO2_LOG_DETAIL wird auch XAUDIO2_LOG_INFO aktiviert.
XAUDIO2_LOG_API_CALLS	Protokollieren von Einträgen und Beenden der öffentlichen API-Funktion.
XAUDIO2_LOG_FUNC_CALLS	Protokollieren Sie interne Funktionseinträge und beenden Sie diese. Hinweis Durch aktivieren XAUDIO2_LOG_FUNC_CALLS wird auch XAUDIO2_LOG_API_CALLS aktiviert.
XAUDIO2_LOG_TIMING	Protokollierte Verzögerungen und andere Zeitsteuerungsdaten.
XAUDIO2_LOG_LOCKS	Protokollieren Sie die Verwendung von kritischen Abschnitten und Mutexes.
XAUDIO2_LOG_MEMORY	Protokollieren sie Informationen zur Heapnutzung des Speichers.
XAUDIO2_LOG_STREAMING	Protokollieren von Audiostreaminginformationen.

BreakMask

Nachrichtentypen, die einen sofortigen Unterbrechung verursachen. Kann 0 oder eine der folgenden Sein:

Wert	BESCHREIBUNG
XAUDIO2_LOG_ERRORS	Unterbrechung bei Fehlermeldungen.
XAUDIO2_LOG_WARNINGS	Unterbrechung bei Warnmeldungen. Hinweis Durch aktivieren XAUDIO2_LOG_WARNINGS wird auch XAUDIO2_LOG_ERRORS aktiviert.

LogThreadID

Gibt an, ob die Thread-ID mit jeder Nachricht protokolliert werden soll.

LogFileline

Gibt an, ob Quelldateien und Zeilennummern protokolliert werden sollen.

LogFunctionName

Gibt an, ob Funktionsnamen protokolliert werden sollen.

LogTiming

Gibt an, ob Nachrichtenzeitstempel protokolliert werden sollen.

Hinweise

Das Debuggen von Nachrichten kann vollständig deaktiviert werden, indem XAUDIO2_DEBUG_CONFIGURATION auf alle Nullen initialisiert wird.

Hinweis Für diese Version von XAudio2 wird nur der XAUDIO2_LOG_ERRORS-Wert in TraceMask oder BreakMask unterstützt. Alle anderen Member und Werte werden ignoriert.

Plattformanforderungen

Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); DirectX SDK (XAudio 2.7)

Anforderungen

Anforderung	Wert
Header	xaudio2.h

Siehe auch

Strukturen

Freigeben über