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 mediante 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 de un archivo de símboloS PDB.

Puede crear un archivo TMF mediante Tracefmt e incluido el parámetro -i , que dirige Tracefmt para crear un archivo TMF para Tracedrv. Para obtener más información, vea 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 a 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 seguimiento en el archivo de origen y el nombre del archivo de origen.

• 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 a 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.