!wmitrace.logdump

L’extension !wmitrace.logdump affiche le contenu des tampons de trace pour une session de trace. Vous pouvez limiter l’affichage aux messages de suivi des fournisseurs spécifiés.

!wmitrace.logdump [-t Count] [{LoggerID|LoggerName} [GUIDFile]] 

Paramètres

-tCount
Limite la sortie aux messages les plus récents. Count spécifie le nombre de messages à afficher.

LoggerID
Spécifie la session de trace. LoggerID est un nombre ordinal que le système affecte à chaque session de trace sur l’ordinateur. Si aucun paramètre n’est spécifié, la session de trace avec l’ID égal à 1 est utilisée.

LoggerName
Spécifie la session de trace. LoggerName est le nom textuel qui a été spécifié lorsque la session de trace a été démarrée.

GUIDFile
Affiche uniquement les messages de trace des fournisseurs spécifiés dans le fichier GUIDFichier. GUIDFile représente le chemin (facultatif) et le nom de fichier d’un fichier texte contenant les GUID de contrôle d’un ou plusieurs fournisseurs de trace, comme un fichier .guid ou .ctl.

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 plus d’informations sur Tracelog, consultez « Tracelog » dans le Kit de pilotes Windows (WDK).

Notes

Pendant le traçage logiciel Windows software trace preprocessor (WPP), les tampons de session de trace sont utilisés pour stocker les messages de trace jusqu’à ce qu’ils soient vidés dans un fichier journal ou à un consommateur de trace pour un affichage en temps réel. L’extension !wmitrace.logdump affiche le contenu des tampons qui se trouvent en mémoire physique. L’affichage apparaît dans la fenêtre de commande du débogueur.

Cette extension est particulièrement utile pour récupérer les traces les plus récentes lorsqu’un crash se produit, et pour afficher les traces stockées dans un fichier de vidage.

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 dans les tampons afin qu’ils puissent être affichés sous forme de texte lisible par l’homme.

Notez que si votre pilote utilise UMDF version 1.11 ou ultérieure, vous n’avez pas besoin d’utiliser !wmitrace.searchpath ou !wmitrace.tmffile.

Lorsque vous utilisez Tracelog pour démarrer une session de trace avec un tampon circulaire (-buffering), utilisez cette extension pour afficher le contenu du tampon.

Pour rechercher l’ID d’enregistreur d’événements d’une session de trace, utilisez l’extension !wmitrace.strdump. Vous pouvez également utiliser le tracelog de commande Tracelog -l pour répertorier les sessions de trace et leurs propriétés de base, y compris l’ID de l’enregistreur d’événements.

Cette extension n’est utile que lors de la traçabilité des logiciels Windows préprocesseur de trace (WPP) et des méthodes antérieures (héritées) de la traçabilité des événements pour Windows. Les événements de trace produits par d’autres fournisseurs manifestés n’utilisent pas de fichiers de format de message de trace (TMF), et donc cette extension n’affiche pas leur contenu.

Cette extension est similaire à l’extension !wmitrace.eventlogdump, sauf que la sortie de !wmitrace.logdump est formatée dans le style WPP, et la sortie de !wmitrace.eventlogdump est formatée dans le style du journal des événements. Vous devriez choisir l’extension dont le format est approprié pour les données que vous souhaitez afficher.

Pour des informations sur la façon de visualiser le journal de trace UMDF, consultez Utilisation du traçage logiciel WPP dans les pilotes basés sur UMDF.