Niveau de suivi

Les niveaux de trace sont des propriétés d’un fournisseur de trace, 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 trace. 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 suivi.

Contrairement aux indicateurs de trace, définis par le fournisseur de trace 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 trace 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 du Kit de développement logiciel (SDK) Microsoft Windows.

Les développeurs de fournisseurs de trace 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, voir 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 trace.

Comme les indicateurs de trace, les utilisateurs peuvent modifier le niveau de trace pendant qu’une session de trace est en cours d’exécution en réexécutant le fournisseur de trace.