Traceur d’appel du pilote WDF (WdfCallTracer)

Vous pouvez utiliser WdfCallTracer pour tracer et afficher la communication des pilotes avec l’infrastructure en temps réel. WdfCallTracer est le nom d’une fonctionnalité et non d’un fichier exécutable distinct (il n’existe pas de fichier binaire distinct pour cela.).

À l’aide de cette fonctionnalité, vous pouvez afficher les appels DDI et d’événements en temps réel.

La procédure suivante vous montre comment configurer WdfTester en utilisant la communication avec le pilote de bus statique KMDF (Statbus.sys disponible dans le WDK). Actuellement, seuls les appels DDI peuvent être consultés.

Pour configurer le traceur d'appels du pilote WDF et compiler le pilote d'exemple

1. Installez l’installation de WdfTester.

2. Compilez l'exemple de pilote de bus statique KMDF (Statbus.sys). L’exemple KMDF se trouve dans le répertoire %WDKRoot%\src\general\toaster\toastDrv\kmdf\bus\static.

3. Copiez l’exemple de pilote de bus dans le répertoire qui contient les fichiers WdfTester que vous avez installés. Chargez le pilote en suivant les instructions pour les exemples de grille-pain KMDF. Utilisez DevCon (Devcon.exe) ou l'Assistant d'ajout de matériel.

Utilisez la procédure suivante pour configurer TraceView afin de pouvoir afficher les appels DDI et d’événements en temps réel

Pour créer une session de journal dans TraceView

1. Démarrez TraceView.exe (%WDKRoot%\tools\<platform>).

2. Dans le menu Fichier , cliquez sur Créer une session de journal.

3. Dans la boîte de dialogue Créer une session de journal , cliquez sur Ajouter un fournisseur.

4. Dans la boîte de dialogue Configuration du GUID du contrôle du fournisseur, cliquez sur Fichier CTL (GUID de contrôle).

5. Cliquez sur le bouton Parcourir , puis sélectionnez le fichier Wdftester.ctl dans le répertoire qui contient les fichiers WdfTester et votre pilote.

6. Cliquez sur OK.

7. Dans la boîte de dialogue Formater la source d’informations, cliquez sur Sélectionner des fichiers TMF, puis sur OK.

8. Dans la boîte de dialogue Configuration des informations du format de trace, cliquez sur Ajouter, puis accédez au répertoire où se trouvent les fichiers WdfTester.

9. Cliquez sur Wdftester.tmf, cliquez sur Ouvrir pour sélectionner le fichier, puis sur Terminé.

10. Cliquez sur Suivant dans la boîte de dialogue Créer une session de journal , puis cliquez sur Terminer.

Vous êtes maintenant prêt à inscrire le pilote et à activer le suivi afin de pouvoir afficher la communication du pilote.

Pour inscrire le pilote KMDF et activer le suivi

1. Ouvrez une fenêtre de l'invite de commande et naviguez vers le répertoire où vous avez installé les fichiers Wdftester.

2. Inscrivez le pilote KMDF (dans cet exemple, Statbus.sys) à l’aide du script WdftesterScript.wsf.

   cscript WdftesterScript.wsf register statbus.sys
   

3. Activez le pilote à partir du Gestionnaire de périphériques ou connectez-vous à votre matériel. Si votre pilote a déjà été activé, utilisez Device Manager pour le désactiver, puis réactivez-le.

Vous devez maintenant voir la communication du pilote dans l’application TraceView.