7. példa: A nyomkövetési üzenet előtagjának testreszabása

Minden nyomkövetési üzenet egy nyomkövetési üzenet előtaggal kezdődik, amely a nyomkövetési üzenet adataiból áll. A nyomkövetési üzenet előtagjának formátuma a %TRACE_FORMAT_PREFIX% környezeti változóban van tárolva. A környezeti változó értékének módosításával testre szabhatja a nyomkövetési üzenet előtagját, hogy a nyomkövetési üzenethez szükséges adatokat az Ön számára leginkább hasznos formátumban jelenítse meg. Az alapértelmezett nyomkövetési üzenet előtagjának változóit és a nyomkövetési üzenet előtagjában használható változókat a Nyomkövetési üzenet előtag témakör ismerteti.

Az alábbi megjelenítés az alapértelmezett nyomkövetési üzenetelőtagot jeleníti meg. A nyomkövetési üzeneteket a Tracedrv, a Windows Driver Kit (WDK) nyomkövetési mintaillesztője hozta létre.

[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
...

Az alapértelmezett előtag formátuma a következő.

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

amely a következő adatokat jelöli:

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

ahol a MessageGUIDFriendlyName alapértelmezés szerint annak a könyvtárnak a neve, amelyben a nyomkövetési szolgáltató létrejött.

Új nyomkövetési üzenet-előtag létrehozásához a set paranccsal állítsa alaphelyzetbe a %TRACE_FORMAT_PREFIX% környezeti változó értékét. Például

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

Ez a parancs a nyomkövetési üzenet előtagjának következő formátumát állítja be:

SourceFile_LineNumber: FunctionName: ProcessID.ThreadID: SystemTime 

Ennek eredményeképpen a Tracefmt-kimenet az új nyomkövetési üzenet előtagot használja, ahogyan az az alábbi megjelenítésben is látható:

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

...

Jegyzet Ha egy parancs- vagy kötegfájlban állítja be a nyomkövetési előtagot, ahol a százalékjel egy parancssori paraméter változója, használjon két egymást követő százalékos szimbólumot az előtagváltozókhoz. Ha például be szeretné foglalni a rendszeridőt az előtagba, írja be a %%4.