!wmitrace.start

L’extension !wmitrace.start démarre l’enregistreur d’événements Event Tracing for Windows (ETW) sur l’ordinateur cible.

!wmitrace.start LoggerName [-cir Size | -seq Size] [-f File] [-b Size] [-max Num] [-min Num] [-kd] [-ft Time] 

Paramètres

LoggerName
Fournit un nom à utiliser pour la session de trace. LoggerName ne peut pas contenir d’espaces ou de guillemets.

-Cir Taille
Fait en sorte que le fichier journal soit écrit de manière circulaire. Size spécifie la taille maximale du fichier, en octets. Lorsque le fichier atteint cette longueur, de nouvelles données seront écrites dans le fichier de manière circulaire, en écrivant par-dessus le fichier du début à la fin. Cela ne peut pas être combiné avec le paramètre -seq. Si ni -cir ni -seq ne sont spécifiés, le fichier est écrit en mode tampon.

-Suiv Num
Fait en sorte que le fichier journal soit écrit de manière séquentielle. Size spécifie la taille maximale du fichier, en octets. Lorsque le fichier atteint cette longueur, les données les plus anciennes seront supprimées du début du fichier chaque fois que de nouvelles données sont ajoutées à la fin. Cela ne peut pas être combiné avec le paramètre -cir. Si ni -cir ni -seq ne sont spécifiés, le fichier est écrit en mode tampon.

-f Lime
Spécifie le nom du fichier journal à créer sur l’ordinateur cible. File doit inclure un chemin d’accès absolu au répertoire, et ne peut pas contenir d’espaces ou de guillemets.

-b Taille
Spécifie la taille de chaque mémoire tampon, en kilo-octets. La plage autorisée de Size est comprise entre 1 et 2048, inclus.

-max Num
Spécifie le nombre maximal de tampons à utiliser. Num peut être n’importe quel entier positif.

-Min Num
Spécifie le nombre minimal de tampons à utiliser. Num peut être n’importe quel entier positif.

-Kd
Active le mode de filtre KD. Les messages seront envoyés au débogueur du noyau et affichés à l’écran.

-Ft Heure
Spécifie la durée du minuteur de vidage, en secondes. À partir de Windows 8, vous pouvez spécifier la durée du minuteur de vidage en millisecondes en ajoutant ms à la valeur de Time. Par exemple, -ft 100ms.

Notez que si vous démarrez une session de traçage en mode de filtre KD (-kd), les tampons de trace sur l’ordinateur cible sont envoyés au débogueur sur l’ordinateur hôte pour affichage. Ce paramètre spécifie à quelle fréquence les tampons sur l’ordinateur cible sont vidés et envoyés à l’ordinateur hôte.

DLL

Wmitrace.dll.

Cette extension est disponible dans Windows 7 et les versions ultérieures de Windows.

Informations supplémentaires

Pour obtenir plus de détails sur les paramètres de cette extension, veuillez consulter StartTraceA Function et EVENT_TRACE_PROPERTIES. Pour voir un aperçu conceptuel de la traçabilité des événements, veuillez consulter Microsoft Windows SDK. Pour des informations sur les outils de traçage, voir le Windows Driver Kit (WDK).

Notes

Après avoir utilisé cette extension, vous devez reprendre l’exécution du programme (par exemple, en utilisant la commande g (Go)) pour qu’elle prenne effet. Après un court laps de temps, l’ordinateur cible se met automatiquement en pause dans le débogueur à nouveau.

Lorsque la session de traçage est démarrée, le système lui attribue un numéro ordinal (l’ID de l’enregistreur d’événements). La session peut ensuite être désignée soit par le nom de l’enregistreur d’événements, soit par l’ID de l’enregistreur d’événements.

Pour arrêter l’enregistreur d’événements ETW, utilisez !wmitrace.stop.