Condividi tramite

File di formato messaggio di traccia

  • Articolo

Il file TMF ( Trace Message Format ) è un file di testo strutturato che contiene istruzioni per l'analisi e la formattazione dei messaggi di traccia binari generati da un provider di traccia . Le istruzioni di formattazione sono incluse nel codice sorgente del provider di traccia e vengono aggiunte al file di simbolo PDB del provider di traccia dal preprocessore WPP.

Alcuni strumenti che registrano e visualizzano messaggi di traccia formattati richiedono un file TMF. Tracefmt e TraceView, strumenti WDK che formattano e visualizzano messaggi di traccia, possono usare un file TMF oppure estrarre le informazioni di formattazione direttamente da un file di simboli PDB.

È possibile creare un file TMF usando Tracefmt e incluso il parametro -i, che indirizza Tracefmt per creare un file TMF per Tracedrv. Per altre informazioni, vedere Esempio 9: Creazione di un file TMF.

Se non si dispone di un file TMF per un provider di traccia, usare Tracepdb. Tracepdb estrae le istruzioni di formattazione dal file di simboli PDB e crea un file TMF per archiviarli. Molti sviluppatori di applicazioni e driver preferiscono inviare un file TMF anziché un file di simboli PDB.

Il nome del file TMF è il GUID del messaggio dei messaggi associati al file TMF. ETW usa il GUID del messaggio per associare messaggi di traccia specifici al file TMF che contiene le istruzioni di formattazione.

Un file TMF contiene i dati seguenti:

  • Nome del file PDB da cui sono stati estratti i dati del file TMF.

  • GUID del messaggio dei messaggi di traccia nel file di origine e nel nome del file di origine.

  • Per ogni messaggio di traccia, una voce che specifica il tipo di messaggio, il nome del file del codice sorgente, un numero di riga, un numero di messaggio, una stringa di definizione del messaggio, un nome del flag di traccia e il nome della funzione C che contiene la chiamata alla macro.

  • Elenco di variabili i cui valori vengono visualizzati nei messaggi di traccia e i relativi nomi di tipo interni associati. Le variabili sono rappresentate dalla notazione %n in una stringa di definizione del messaggio.

Nota Il file TMF è riservato per l'uso interno e il relativo formato è soggetto a modifiche tra versioni diverse di Windows.