Niveau de suivi

Les niveaux de trace sont des propriétés d’un fournisseur de traces, comme un pilote en mode noyau ou une application en mode utilisateur. Les niveaux de trace déterminent les événements générés par le fournisseur de traces. En règle générale, le niveau de trace représente la gravité de l’événement (informations, avertissement ou erreur), mais les fournisseurs de trace peuvent les définir pour représenter n’importe quelle condition pour générer le message de trace.

Contrairement aux indicateurs de trace, qui sont définis par le fournisseur de traces dans la structure WPP_CONTROL_GUIDS , les niveaux de trace sont définis dans Evntrace.h, un fichier d’en-tête public. Toutefois, le fournisseur de trace interprète le niveau et détermine son effet

Les consommateurs de suivi, tels que Tracelog et TraceView, passent un niveau de trace au fournisseur dans le paramètre EnableLevel de la fonction EnableTrace . Pour plus d’informations sur EnableTrace, consultez la documentation Microsoft Windows SDK.

Les développeurs de fournisseurs de traces peuvent également écrire des fonctions de suivi personnalisées (alternatives à DoTraceMessage) qui incluent le niveau de trace comme condition pour générer le message de trace. Pour obtenir des instructions, consultez Puis-je personnaliser DoTraceMessage ?

Lors de l’exécution d’une session de suivi, les utilisateurs peuvent utiliser le niveau de trace pour déterminer les messages qui seront générés pendant la session. Les consommateurs de trace, tels que Tracelog et TraceView, permettent aux utilisateurs de définir des paramètres et des options pour sélectionner les indicateurs de trace et le niveau de trace pour chaque fournisseur dans une session de suivi.

À l’instar des indicateurs de trace, les utilisateurs peuvent modifier le niveau de trace pendant qu’une session de suivi est en cours d’exécution en réenablant le fournisseur de trace.