Compartir a través de

Ejemplo 7: Personalización del prefijo de mensaje de seguimiento

  • Artículo

Cada mensaje de seguimiento comienza con un prefijo de mensaje de seguimiento compuesto por datos sobre el mensaje de seguimiento. El formato del prefijo del mensaje de seguimiento se almacena en la variable de entorno %TRACE_FORMAT_PREFIX%. Al cambiar el valor de la variable de entorno, puede personalizar el prefijo del mensaje de seguimiento para mostrar los datos que necesita sobre el mensaje de seguimiento en el formato más útil para usted. Las variables del prefijo de mensaje de seguimiento predeterminado y todas las variables que puede usar en un prefijo de mensaje de seguimiento se describen en el tema Prefijo de mensaje de seguimiento.

En la siguiente pantalla se muestra el prefijo de mensaje de seguimiento predeterminado. Tracedrv generó los mensajes de seguimiento, el controlador de ejemplo habilitado para seguimiento en el Kit de controladores de Windows (WDK).

[0]0AF4.0C64::07/25/2003-14:55:39.998 [tracedrv]IOCTL = 1
[0]0AF4.0C64::07/25/2003-14:55:39.998 [tracedrv]Hello, 1 Hi
[0]0AF4.0C64::07/25/2003-14:55:39.998 [tracedrv]Hello, 2 Hi
...

El formato del prefijo predeterminado es el siguiente.

[%9!d!]%8!04X!.%3!04X!::%4!s! [%1!s!]

que representa los datos siguientes:

[CPUNumber]ProcessID.ThreadID::SystemTime [MessageGUIDFriendlyName]

donde MessageGUIDFriendlyName es, de forma predeterminada, el nombre del directorio en el que se creó el proveedor de seguimiento.

Para crear un nuevo prefijo de mensaje de seguimiento, use el comando set para restablecer el valor de la variable de entorno %TRACE_FORMAT_PREFIX%. Por ejemplo,

set TRACE_FORMAT_PREFIX=%2!s!: %!FUNC!: %8!04x!.%3!04x!: %4!s!:

Este comando establece el prefijo del mensaje de seguimiento con el formato siguiente:

SourceFile_LineNumber: FunctionName: ProcessID.ThreadID: SystemTime

Como resultado, la salida de Tracefmt usa el nuevo prefijo de mensaje de seguimiento, como se muestra en la siguiente pantalla:

tracedrv_c258: TracedrvDispatchDeviceControl: 0af4.0c64: 07/25/2003-13:55:39.998:  IOCTL = 1
tracedrv_c264: TracedrvDispatchDeviceControl: 0af4.0c64: 07/25/2003-13:55:39.998:  Hello, 1 Hi
tracedrv_c264: TracedrvDispatchDeviceControl: 0af4.0c64: 07/25/2003-13:55:39.998:  Hello, 2 Hi
tracedrv_c264: TracedrvDispatchDeviceControl: 0af4.0c64: 07/25/2003-13:55:39.998:  Hello, 3 Hi

...

Nota Si va a establecer el prefijo de seguimiento en un comando o archivo por lotes, donde el símbolo de porcentaje representa una variable para un parámetro de línea de comandos, use dos símbolos de porcentaje consecutivos para las variables de prefijo. Por ejemplo, para incluir la hora del sistema en el prefijo, escriba %%4.