!wmitrace.searchpath

L’extension !wmitrace.searchpath spécifie l’emplacement des fichiers de format de message de trace pour les messages dans les tampons de trace.

!wmitrace.searchpath [+] TMFPath 
!wmitrace.searchpath

Paramètres

+
Fait que TMFPath soit ajouté au chemin de recherche existant. Si le jeton plus (+) n’est pas utilisé, TMFPath remplace le chemin de recherche existant.

TMFPath
Le chemin vers le répertoire où le débogueur doit rechercher les fichiers de format de message de trace. Les chemins contenant des espaces ne sont pas pris en charge. Si plusieurs chemins sont inclus, ils doivent être séparés par des points-virgules, et l’ensemble de la chaîne doit être placé entre guillemets. Si le chemin est entre guillemets, le caractère antislash doit être précédé d’un caractère d’échappement ( "c:\\debuggers;c:\\debuggers2" ). Lorsque le jeton + est utilisé, TMFPath sera ajouté au chemin existant, avec un point-virgule automatiquement inséré entre le chemin existant et le nouveau chemin ; cependant, si le jeton + est utilisé, les guillemets ne peuvent pas être utilisés.

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 des informations sur les fichiers de format de message de trace, veuillez consulter la rubrique « Fichiers de format de message de trace » dans la documentation Windows Driver Kit (WDK).

Notes

Lorsqu’elle est utilisée sans paramètres, !wmitrace.searchpath affiche le chemin de recherche actuel.

Les fichiers de format de message de trace (*.tmf) contiennent des instructions pour formater les messages de trace binaires qu’un fournisseur de trace génère.

Le paramètre TMFPath ne doit contenir qu’un chemin vers un répertoire ; il ne peut pas inclure de nom de fichier. Le nom d’un fichier TMF est un GUID de message suivi de l’extension .tmf. Lorsque le système formate un message, il lit le GUID de message sur le message et recherche de manière récursive un fichier TMF dont le nom correspond au GUID de message, en commençant dans le répertoire spécifié.

Windows a besoin d’un fichier TMF pour formater les messages de trace binaires dans un tampon. Utilisez !wmitrace.searchpath ou !wmitrace.tmffile pour spécifier le fichier TMF avant d’utiliser !wmitrace.dynamicprint ou !wmitrace.logdump pour afficher le contenu du tampon de trace.

Si vous n’utilisez ni !wmitrace.searchpath ni !wmitrace.tmffile, le système utilise la valeur de la variable d’environnement TRACE_FORMAT_SEARCH_PATH. Si cette variable n’est pas présente, il utilise le fichier default.tmf, qui est inclus dans Windows. Si le système ne trouve aucune information de formatage pour un message de trace, il écrit un message d’erreur « Aucune information de format trouvée » à la place du contenu du message de trace.