!wmitrace.tmffile

L’extension !wmitrace.tmffile spécifie un fichier de format de message de trace (TMF). Le fichier spécifié par cette extension est utilisé pour formater les messages de trace affichés ou écrits par d’autres extensions de traçage WMI.

!wmitrace.tmffile TMFFile 

Paramètres

TMFFile
Spécifie un fichier de format de message de trace.

DLL

Wmitrace.dll

Informations supplémentaires

Pour voir un aperçu conceptuel de la traçabilité des événements, veuillez consulter Microsoft Windows SDK. Pour obtenir plus d’informations sur les fichiers de format de message de trace, veuillez consulter la rubrique « Fichier de format de message de trace » dans le Kit de développement de pilotes Windows (WDK).

Notes

Les fichiers de format de message de trace (.tmf) sont des fichiers texte structurés créés lors du traçage logiciel du préprocesseur de trace logicielle (WPP) Windows. Ces fichiers contiennent des instructions pour formater les messages de trace binaires afin qu’ils puissent être affichés sous une forme lisible par l’homme.

Pour afficher le message de trace dans un tampon de trace (!wmitrace.logdump) ou les écrire dans un fichier (!wmitrace.logsave), vous devez d’abord identifier les fichiers TMF pour les messages de trace.

Vous pouvez utiliser !wmitrace.searchpath pour spécifier un répertoire dans lequel les fichiers TMF sont stockés. Le système recherche ensuite le répertoire à la recherche d’un fichier TMF qui contient des instructions pour les messages qu’il formate. (Il utilise le GUID de message pour associer le message au bon fichier TMF.)

Cependant, vous pouvez utiliser !wmitrace.tmffile pour spécifier un fichier TMF particulier. Vous devez utiliser !wmitrace.tmffile si le nom du fichier TMF n’est pas un GUID de message suivi de l’extension .tmf. Sinon, le système ne le trouvera pas.

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. Si le système ne peut pas trouver d’informations de formatage pour un message de trace, il écrit le message d’erreur « Aucune information de format trouvée », au lieu du contenu du message de trace.

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.

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 traçage produits par d’autres fournisseurs manifestés n’utilisent pas de fichiers de format de message de trace (TMF), et donc cette extension ne peut pas être utilisée avec eux.