Partager via

Ajout de macros WPP à un fournisseur de traces

  • Article

Pour ajouter la forme par défaut du suivi logiciel WPP à un fournisseur de traces, tel qu’un pilote en mode noyau ou une application en mode utilisateur, ajoutez les directives de préprocesseur C et les appels de macro WPP suivants au code source du fournisseur :

  • Une directive #include de la forme suivante pour chaque fichier source qui contient des macros WPP. Cette instruction inclut le fichier d’en-tête de message de trace créé par le préprocesseur WPP pour chaque fichier source :

    #include <source-file-name.tmh>

    Le fichier d’en-tête de message de trace doit être inclus dans un fichier source avant tout appel de macro WPP et après avoir défini une macro WPP_CONTROL_GUIDS .

  • Une WPP_CONTROL_GUIDS directive de définition pour chaque fichier source qui inclut d’autres macros WPP.

    Cette définition spécifie le GUID de contrôle du pilote et les noms d’indicateurs de trace définis par le pilote. La définition doit être ajoutée à un fichier source avant l’instruction #include qui inclut le fichier d’en-tête de message de trace du fichier.

  • Un WPP_INIT_TRACING appel de macro au code source du pilote.

    Pour les pilotes, cette macro active le suivi logiciel dans le pilote. Cette macro est généralement appelée lors de l’initialisation du pilote, par exemple dans une routine DriverEntry .

    Pour les applications en mode utilisateur, appelez cette macro à un point de votre code source où aucune tentative de traçage n’a été effectuée précédemment.

    Après l’initialisation, vous pouvez utiliser TraceView ou Tracelog pour démarrer une session de suivi logiciel et afficher des messages de suivi.

  • Une WPP_CLEANUP appel de macro au code source du fournisseur de trace . Cette macro désactive le suivi logiciel dans le pilote.

    Pour les pilotes, cet appel de macro est généralement ajouté à la routine de déchargement du pilote.

    Pour les applications en mode utilisateur, appelez cette macro à un point de votre code source après les dernières tentatives de suivi.

  • Appels de macro DoTraceMessage pour journaliser les messages de trace.