!wmitrace.dynamicprint

L’extension !wmitrace.dynamicprint contrôle si le débogueur affiche les messages de trace générés par une session s’exécutant en mode KD_FILTER_MODE.

!wmitrace.dynamicprint {0 | 1}

Paramètres

0
Éteint l’affichage des messages de trace.

1
Allume l’affichage des messages de trace.

DLL

Wmitrace.dll

Cette extension est disponible dans Windows 2000 et les versions ultérieures de Windows. Si vous souhaitez utiliser cette extension avec Windows 2000, vous devez d’abord copier le fichier Wmitrace.dll du sous-répertoire winxp du répertoire d’installation de Debugging Tools for Windows vers le sous-répertoire w2kfre.

Informations supplémentaires

Pour voir un aperçu conceptuel de la traçabilité des événements, veuillez consulter Microsoft Windows SDK. Pour obtenir de l’aide pour démarrer une session de trace, veuillez consulter « Tracelog » dans le Kit de développement de pilotes Windows (WDK).

Notes

Avant d’utiliser cette extension, démarrez une session de trace et spécifiez que les messages de trace doivent être envoyés au débogueur. Par exemple, si vous utilisez !wmitrace.start pour démarrer la session, utilisez le paramètre -kd. Si vous utilisez Tracelog pour démarrer la session de trace, utilisez son paramètre -kd. Tracelog (tracelog.exe) est un contrôleur de trace inclus dans le Kit de développement de pilotes Windows.

Les messages de trace sont conservés dans des tampons sur l’ordinateur cible. Ces tampons sont vidés et envoyés au débogueur sur l’ordinateur hôte à intervalles réguliers. Vous pouvez spécifier l’intervalle du minuteur de vidage en utilisant le paramètre -kd de la commande !wmitrace.start ou le paramètre -kd de l’outil Tracelog. À partir de Windows 8, vous pouvez spécifier la valeur du minuteur de vidage en millisecondes en ajoutant ms à la valeur du minuteur de vidage.

Par défaut, ETW maintient des tampons de trace par processeur sur l’ordinateur cible. Lorsque les tampons de trace sont vidés et envoyés au débogueur sur l’ordinateur hôte, il n’y a aucun mécanisme pour fusionner les tampons en une séquence chronologique d’événements. Les événements peuvent donc être affichés dans le désordre. À partir de Windows 7, vous pouvez résoudre ce problème en définissant le paramètre -lowcapacity lorsque vous utilisez l’outil Tracelog pour démarrer une session de trace.

Tracelog MySession -kd -lowcapacity

Lorsque vous démarrez une session avec -lowcapacity défini, tous les événements vont dans un seul tampon sur l’ordinateur cible, et les événements sont affichés dans le bon ordre dans le débogueur sur l’ordinateur hôte.

De plus, avant d’utiliser cette extension, utilisez !wmitrace.searchpath ou !wmitrace.tmffile pour spécifier les fichiers de format de message de trace. Le système utilise les fichiers de format de message de trace pour formater les messages de trace binaires afin qu’ils puissent être affichés sous forme de texte lisible par l’homme.

Voir aussi

!wmitrace.start