Partager via

Utilisation du suivi logiciel WPP dans les pilotes KMDF

  • Article

Le suivi logiciel WPP vous permet d’ajouter des messages de suivi qui vous aident à déboguer votre pilote. En outre, l’enregistreur d’événements de l’infrastructure fournit des centaines de messages de suivi que vous pouvez afficher.

Vous pouvez afficher les messages de suivi à l’aide de TraceView ou Tracelog. Vous pouvez également envoyer des messages de trace à un débogueur de noyau.

Ajout de messages de suivi à votre pilote

Pour ajouter des messages de suivi à votre pilote basé sur l’infrastructure, vous devez :

  • Ajoutez une directive #include à chacun des fichiers sources de votre pilote qui contient l’une des macros WPP. Cette directive doit identifier un fichier d’en-tête de message de trace (TMH). Le nom de fichier doit avoir un format driver-source-file-name.tmh><.

    Par exemple, si votre pilote se compose de deux fichiers sources, appelés MyDriver1.c et MyDriver2.c, MyDriver1.c doit contenir :

    #include « MyDriver1.tmh »

    et MyDriver2.c doivent contenir :

    #include « MyDriver2.tmh »

    Lorsque vous générez votre pilote dans Microsoft Visual Studio, le préprocesseur WPP génère le . fichiers tmh .

  • Définissez une macro WPP_CONTROL_GUIDS dans un fichier d’en-tête. Cette macro définit un GUID et des indicateurs de trace pour les messages de suivi de votre pilote.

  • Incluez une macro WPP_INIT_TRACING dans la routine DriverEntry de votre pilote. Cette macro active le suivi logiciel dans votre pilote.

  • Incluez une macro WPP_CLEANUP dans la fonction de rappel EvtDriverUnload de votre pilote. Cette macro désactive le suivi logiciel dans votre pilote.

  • Utilisez la macro DoTraceMessage ou une version personnalisée de la macro dans votre pilote pour créer des messages de trace.

  • Ouvrez les pages de propriétés de votre projet de pilote. Cliquez avec le bouton droit sur le projet de pilote dans Explorateur de solutions, puis sélectionnez Propriétés. Dans les pages de propriétés du pilote, cliquez sur Propriétés de configuration, puis sur Suivi Wpp. Dans le menu Général , définissez Exécuter le suivi WPP sur Oui. Dans le menu Options de fichier, vous devez également spécifier le fichier de modèle WPP de l’infrastructure, par exemple :

    {km-WdfDefault.tpl}*.tmh

  • Pour spécifier des paramètres de trace WPP supplémentaires pour votre projet de pilote dans Visual Studio, cliquez avec le bouton droit sur le projet de pilote dans Solutions Explorer. Suivez ensuite le lien vers Propriétés-Configuration> Propriétés-Suivi> WPP.

  • Pour spécifier un fichier de configuration de trace, utilisez le paramètre « Analyser les données de configuration ». Pour plusieurs fichiers de configuration de trace, ajoutez-le sous « Ligne de commande » -> « Options supplémentaires » comme suit

    -scan:"$(KMDF_INC_PATH)\$(KMDF_VER_PATH)\wdftraceenums.h"

    Pour plus d’informations sur l’ajout de messages de suivi à votre pilote, consultez Ajout de macros WPP à un pilote.

Exemples de pilotes qui utilisent le suivi logiciel WPP

Les exemples de pilotes AMCC5933, NONPNP, KMDF_FX2, PCIDRV, PLX9x5x et Serial utilisent le suivi logiciel WPP.