!wmitrace.tmffile

La extensión !wmitrace.tmffile especifica un archivo de formato de los mensajes de seguimiento (TMF). El archivo especificado por esta extensión se utiliza para dar formato a los mensajes de seguimiento mostrados o escritos por otras extensiones de seguimiento de WMI.

!wmitrace.tmffile TMFFile 

Parámetros

TMFFile
Especifica un archivo de formato para los mensajes de seguimiento.

Archivo DLL

Wmitrace.dll

Información adicional

Para obtener una descripción conceptual general del seguimiento de eventos, consulte Microsoft Windows SDK. Para obtener información sobre los archivos de formato para los mensajes de seguimiento, consulte el tema "Archivo de formato para los mensajes de seguimiento" en el Kit para controladores de Windows (WDK).

Comentarios

Los archivos de formato de los mensajes de seguimiento (.tmf) son archivos de texto estructurados que se crean durante el seguimiento de software del preprocesador de seguimiento de software (WPP) de Windows. Estos archivos contienen instrucciones para dar formato a los mensajes de seguimiento binarios de seguimiento para poder mostrarlos en un formato legible por humanos.

Para visualizar el mensaje de seguimiento en un búfer de seguimiento (!wmitrace.logdump) o escribirlo en un archivo (!wmitrace.logsave), primero es necesario identificar los archivos TMF para los mensajes de seguimiento.

Es posible utilizar !wmitrace.searchpath para especificar el directorio donde se almacenan los archivos TMF. De este modo, el sistema busca en el directorio un archivo TMF que contiene instrucciones para los mensajes a los que se va a dar formato. (Utiliza el GUID del mensaje para asociar el mensaje con el archivo TMF correcto).

Sin embargo, es posible utilizar !wmitrace.tmffile para especificar un archivo TMF determinado. Es necesario utilizar !wmitrace.tmffile si el nombre del archivo TMF no es un GUID de mensaje seguido de la extensión .tmf. De lo contrario, el sistema no lo podrá encontrar.

Si no se utiliza !wmitrace.searchpath o !wmitrace.tmffile, el sistema utiliza el valor de la variable de entorno TRACE_FORMAT_SEARCH_PATH. Si esa variable no está presente, utiliza el archivo default.tmf. Si el sistema no encuentra información de formato para un mensaje de seguimiento, escribe un mensaje de error "No se ha encontrado información de formato", en lugar del contenido del mensaje de seguimiento.

Nota Si el controlador utiliza UMDF versión 1.11 o posterior, no es necesario utilizar !wmitrace.searchpath ni !wmitrace.tmffile.

Esta extensión solo es útil durante el seguimiento de software de WPP y métodos anteriores (heredados) de seguimiento de eventos para Windows. Los eventos de seguimiento generados por otros proveedores indicados no utilizan archivos de formato para los mensajes de seguimiento (TMF) y, por tanto, no se puede utilizar esta extensión con ellos.