Exemple 5 : mise en forme Real-Time sessions de trace

Vous pouvez utiliser Tracefmt pour mettre en forme les messages de trace à partir de sessions de suivi en temps réel en plus des fichiers journaux de suivi.

La séquence de commandes suivante utilise Tracelog et Tracefmt. La première commande utilise Tracelog pour démarrer une session de suivi en temps réel avec l’exemple de fournisseur de trace Tracedrv. TraceDrv, un exemple de pilote qui a été conçu pour le suivi logiciel, est disponible dans le référentiel d’exemples de pilotes Windows sur GitHub.

tracelog -start MyTrace -guid tracedrv.ctl -flag 1 -rt

Cette commande démarre une session de trace appelée MyTrace. Il utilise le paramètre -guid pour identifier le fournisseur de trace, Tracedrv.sys, à l’aide de son fichier GUID de contrôle, tracedrv.ctl. Il utilise le paramètre -flag pour définir la valeur de l’indicateur de trace sur 1. Il utilise le paramètre -rt pour démarrer une session de trace qui remet des messages directement à un consommateur de trace, tel que Tracefmt. Sans le paramètre -rt , le fournisseur de trace envoie des messages uniquement à un fichier journal.

La commande suivante utilise Tracefmt pour mettre en forme les messages générés par Tracedrv pendant la session de suivi MyTrace.

tracefmt -rt MyTrace -p c:\tracing -o mytrace.txt

Cette commande Tracefmt utilise le paramètre -rt pour identifier la session de trace en temps réel, MyTrace et le paramètre -p pour spécifier le répertoire dans lequel se trouve le fichier TMF pour Tracedrv.sys. Le paramètre -o dirige la sortie vers le fichier mytrace.txt dans le répertoire local.

En réponse à cette commande, Tracefmt se prépare à mettre en forme les messages de trace en temps réel. Il affiche les messages status suivants, mais ne retourne pas à l’invite de commandes :

c:\tracetools>tracefmt -rt mytrace -display -o mytrace.txt
Setting RealTime mode for  mytrace
Getting guids from c:\tracetools\default.tmf

La commande Tracelog suivante arrête la session de trace MyTrace. Vous devez taper la commande dans une autre fenêtre d’invite de commandes.

tracelog -stop mytrace

Lorsque la session de suivi s’arrête, Tracefmt signale qu’il a écrit les messages de trace dans le fichier de sortie, puis retourne à l’invite de commandes.

Event traces dumped to mytrace.txt
Event Summary dumped to mytrace.txt.sum