XAUDIO2_DEBUG_CONFIGURATION structure (xaudio2.h)

Article
03/04/2024

Contient la nouvelle configuration globale de débogage pour XAudio2. Utilisé avec la fonction SetDebugConfiguration .

Syntaxe

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

Membres

TraceMask

Masque de bits des types de messages de débogage activés. Il peut s’agir de 0 ou d’un ou plusieurs des éléments suivants :

Valeur	Description
XAUDIO2_LOG_ERRORS	Consigner les messages d’erreur.
XAUDIO2_LOG_WARNINGS	Consignez les messages d’avertissement. Note L’activation de XAUDIO2_LOG_WARNINGS permet également d’XAUDIO2_LOG_ERRORS.
XAUDIO2_LOG_INFO	Consignez les messages d’information.
XAUDIO2_LOG_DETAIL	Journaliser des messages d’information détaillés. Note L’activation de XAUDIO2_LOG_DETAIL permet également d’XAUDIO2_LOG_INFO.
XAUDIO2_LOG_API_CALLS	Journaliser les entrées et les sorties de fonction d’API publique.
XAUDIO2_LOG_FUNC_CALLS	Journaliser les entrées et les sorties de fonction interne. Note L’activation de XAUDIO2_LOG_FUNC_CALLS permet également de XAUDIO2_LOG_API_CALLS.
XAUDIO2_LOG_TIMING	Retards de journal détectés et autres données de minutage.
XAUDIO2_LOG_LOCKS	Journaliser l’utilisation des sections critiques et des mutex.
XAUDIO2_LOG_MEMORY	Informations d’utilisation du tas de mémoire du journal.
XAUDIO2_LOG_STREAMING	Journaliser les informations de streaming audio.

BreakMask

Types de messages qui entraînent un arrêt immédiat. Peut être égal à 0 ou à l’un des éléments suivants :

Valeur	Description
XAUDIO2_LOG_ERRORS	Arrêtez les messages d’erreur.
XAUDIO2_LOG_WARNINGS	Arrêtez les messages d’avertissement. Note L’activation de XAUDIO2_LOG_WARNINGS permet également d’XAUDIO2_LOG_ERRORS.

LogThreadID

Indique s’il faut enregistrer l’ID de thread avec chaque message.

LogFileline

Indique s’il faut enregistrer les fichiers sources et les numéros de ligne.

LogFunctionName

Indique s’il faut journaliser les noms des fonctions.

LogTiming

Indique s’il faut enregistrer les horodatages des messages.

Remarques

Le débogage des messages peut être complètement désactivé en initialisant XAUDIO2_DEBUG_CONFIGURATION à tous les zéros.

Note Pour cette version de XAudio2, seule la valeur XAUDIO2_LOG_ERRORS est prise en charge sur TraceMask ou BreakMask. Tous les autres membres et valeurs sont ignorés.

Configuration requise pour la plateforme

Windows 10 (XAudio2.9) ; Windows 8, Windows Phone 8 (XAudio 2.8) ; Kit de développement logiciel (SDK) DirectX (XAudio 2.7)

Configuration requise

Condition requise	Valeur
En-tête	xaudio2.h

Voir aussi

Structures

Partager via