!wmitrace.searchpath
La extensión !wmitrace.searchpath especifica la ubicación de los archivos de formato de los mensajes de seguimiento para los mensajes de los búferes de seguimiento.
!wmitrace.searchpath [+] TMFPath
!wmitrace.searchpath
Parámetros
+
Hace que se añada TMFPath a la ruta acceso para búsquedas existente. Si no se utiliza el token más (+), TMFPath sustituye a la ruta de acceso de búsqueda existente.
TMFPath
Ruta de acceso al directorio donde el depurador debe buscar los archivos de formato de los mensajes de seguimiento. No se admiten rutas de acceso que contengan espacios. Si se incluye más de una ruta de acceso, los distintos valores deben estar separados por punto y coma y toda la cadena debe estar encerrada entre comillas. Si la ruta de acceso está entrecomillada, el carácter de barra diagonal inversa debe ir precedido por un carácter de escape ("c:\\debuggers;c:\\debuggers2"). Cuando se utiliza el token +, TMFPath se añadirá a la ruta de acceso existente, con un punto y coma insertado automáticamente entre la ruta de acceso existente y la nueva ruta de acceso. Sin embargo, si se utiliza el token +, no se pueden utilizar comillas.
Archivo DLL
Wmitrace.dll
Esta extensión está disponible en Windows 2000 y versiones de Windows posteriores. Para utilizar esta extensión con Windows 2000, primero es necesario copiar el archivo Wmitrace.dll del subdirectorio winxp del directorio de instalación de las herramientas de depuración para Windows en el subdirectorio w2kfre.
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 "Archivos de formato para los mensajes de seguimiento" en el Kit para controladores de Windows (WDK).
Comentarios
Cuando se utiliza sin parámetros, !wmitrace.searchpath muestra la ruta de acceso de búsqueda actual.
Los archivos de formato de mensaje de seguimiento (*.tmf) contienen instrucciones para dar formato a los mensajes de seguimiento binarios generados por un proveedor de seguimiento.
El parámetro TMFPath solo debe contener una ruta de acceso a un directorio. No puede incluir ningún nombre de archivo. El nombre de un archivo TMF es un GUID de mensaje seguido por la extensión .tmf. Cuando el sistema da formato a un mensaje, lee el GUID del mensaje en el propio mensaje y busca de forma recursiva un archivo TMF cuyo nombre coincida con el GUID del mensaje, empezando por el directorio especificado.
Windows necesita un archivo TMF para dar formato a los mensajes de seguimiento binarios de un búfer. Utilice !wmitrace.searchpath o !wmitrace.tmffile para especificar el archivo TMF antes de utilizar !wmitrace.dynamicprint o !wmitrace.logdump para mostrar el contenido del búfer de seguimiento.
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, se utiliza el archivo default.tmf, que está incluido en Windows. Si el sistema no encuentra ninguna 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.