Esempio 7: Personalizzazione del prefisso del messaggio di traccia

  • Articolo

Ogni messaggio di traccia inizia con un prefisso del messaggio di traccia composto da dati relativi al messaggio di traccia. Il formato del prefisso del messaggio di traccia viene archiviato nella variabile di ambiente %TRACE_FORMAT_PREFIX%. Modificando il valore della variabile di ambiente, è possibile personalizzare il prefisso del messaggio di traccia per visualizzare i dati necessari sul messaggio di traccia nel formato più utile. Le variabili nel prefisso del messaggio di traccia predefinite e tutte le variabili che è possibile usare in un prefisso del messaggio di traccia sono descritte nell'argomento Prefisso messaggio di traccia.

La visualizzazione seguente mostra il prefisso del messaggio di traccia predefinito. I messaggi di traccia sono stati generati da Tracedrv, il driver di esempio abilitato per la traccia in Windows Driver Kit (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
...

Il formato del prefisso predefinito è il seguente.

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

che rappresenta i dati seguenti:

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

dove messageGUIDFriendlyName è, per impostazione predefinita, il nome della directory in cui è stato compilato il provider di traccia.

Per creare un nuovo prefisso del messaggio di traccia, usare il comando set per reimpostare il valore della variabile di ambiente %TRACE_FORMAT_PREFIX%. Ad esempio,

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

Questo comando imposta il formato di prefisso del messaggio di traccia:

SourceFile_LineNumber: FunctionName: ProcessID.ThreadID: SystemTime

Di conseguenza, l'output Tracefmt usa il nuovo prefisso del messaggio di traccia, come illustrato nella visualizzazione seguente:

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 Se si imposta il prefisso di traccia in un comando o in un file batch, in cui il simbolo percentuale rappresenta una variabile per un parametro della riga di comando, usare due simboli di percentuale consecutivi per le variabili di prefisso. Ad esempio, per includere l'ora di sistema nel prefisso, digitare %%4.