Archivo de formato de mensaje de seguimiento

El archivo de formato de mensaje de seguimiento (TMF) es un archivo de texto estructurado que contiene instrucciones para analizar y dar formato a los mensajes de seguimiento binarios que genera un proveedor de seguimiento . Las instrucciones de formato se incluyen en el código fuente del proveedor de seguimiento y se agregan al archivo de símboloS PDB del proveedor de seguimiento por el preprocesador de WPP.

Algunas herramientas que registran y muestran mensajes de seguimiento con formato requieren un archivo TMF. Tracefmt y TraceView, herramientas de WDK que dan formato y muestran mensajes de seguimiento, pueden usar un archivo TMF o pueden extraer la información de formato directamente desde un archivo de símbolos PDB.

Puede crear un archivo TMF mediante Tracefmt e incluir el parámetro -i , que dirige Tracefmt para crear un archivo TMF para Tracedrv. Para obtener más información, consulta Ejemplo 9: Crear un archivo TMF.

Si no tiene un archivo TMF para un proveedor de seguimiento, use Tracepdb. Tracepdb extrae las instrucciones de formato del archivo de símbolos PDB y crea un archivo TMF para almacenarlos. Muchos desarrolladores de aplicaciones y controladores prefieren enviar un archivo TMF, en lugar de un archivo de símboloS PDB.

El nombre del archivo TMF es el GUID del mensaje de los mensajes asociados con ese archivo TMF. ETW usa el GUID del mensaje para asociar mensajes de seguimiento concretos al archivo TMF que contiene sus instrucciones de formato.

Un archivo TMF contiene los datos siguientes:

• Nombre del archivo PDB del que se extrajeron los datos del archivo TMF.

• GUID del mensaje de los mensajes de traza en el archivo fuente y el nombre del archivo fuente.

• Para cada mensaje de seguimiento, una entrada que especifica el tipo de mensaje, el nombre del archivo de código fuente, un número de línea, un número de mensaje, una cadena de definición de mensaje, un nombre de marca de seguimiento y el nombre de la función de C que contiene la llamada de macro.

• Lista de variables cuyos valores aparecen en los mensajes de seguimiento y sus nombres de tipo internos asociados. Las variables se representan mediante la notación %n en una cadena de definición de mensaje.

Nota El archivo TMF está reservado para uso interno y su formato está sujeto a cambios entre diferentes versiones de Windows.