Exemple 16 : Affichage des messages de trace dans un débogueur

Cet exemple montre comment rediriger les messages de trace vers KD ou WinDbg.

Avant de commencer la session de suivi, vérifiez que Wmitrace.dll et Traceprt.dll se trouvent dans le chemin de recherche du débogueur sur l’ordinateur hôte. Ces DLL sont incluses dans Outils de débogage pour Windows dans le répertoire \Program Files\Debugging Tools for Windows\winxp. (Malgré le nom du répertoire, les fichiers fonctionnent dans Windows 2000 et les versions ultérieures de Windows.)

Vérifiez également que les fichiers de format de message de trace (TMF) du fournisseur de trace se trouvent dans le chemin de recherche du débogueur.

Pour définir le chemin de recherche du débogueur, utilisez l’extension de débogueur spécialisé !wmitrace.searchpath ou définissez la valeur de la variable d’environnement %TRACE_FORMAT_SEARCH_PATH%. Par exemple :

set TRACE_FORMAT_SEARCH_PATH=c:\tracing

Ensuite, démarrez le débogueur. Si vous envoyez une commande Tracelog avec le paramètre -kd et qu’un débogueur n’est pas en cours d’exécution, Tracelog cesse de répondre (« se bloque »).

La commande suivante démarre une session de suivi et envoie les messages de trace à KD ou à Windbg, selon la valeur attachée.

tracelog -start MyTrace -guid MyProvider.ctl -rt -kd

La commande tracelog -start inclut un nom de session pour démarrer la session de suivi. Il utilise le paramètre -guid pour identifier le fichier fournisseur. Il utilise également le paramètre -rt pour démarrer une session de suivi en temps réel, afin que les messages de trace soient envoyés au débogueur et non à un fichier journal.

En réponse, Tracelog signale qu’il a démarré la session. Lorsque le fournisseur de trace génère des messages, ceux-ci s’affichent dans le débogueur.

Pour afficher les messages dans le débogueur, utilisez les extensions de suivi WMI. Pour plus d’informations, consultez Outils de débogage pour Windows.