Contoh 7: Menyesuaikan Awalan Pesan Pelacakan

Setiap pesan jejak dimulai dengan awalan pesan pelacakan yang terdiri dari data tentang pesan jejak. Format awalan pesan pelacakan disimpan dalam variabel lingkungan %TRACE_FORMAT_PREFIX%. Dengan mengubah nilai variabel lingkungan, Anda dapat menyesuaikan awalan pesan pelacakan untuk menampilkan data yang Anda butuhkan tentang pesan pelacakan dalam format yang paling berguna bagi Anda. Variabel dalam awalan pesan pelacakan default, dan semua variabel yang dapat Anda gunakan dalam awalan pesan pelacakan dijelaskan dalam topik Awalan Pesan Pelacakan.

Tampilan berikut ini menunjukkan awalan pesan pelacakan bawaan. Pesan jejak dihasilkan oleh Tracedrv, driver sampel yang dilengkapi fitur pelacakan di dalam 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
...

Format awalan default adalah sebagai berikut.

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

yang mewakili data berikut:

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

di mana MessageGUIDFriendlyName adalah, secara default, nama direktori tempat penyedia pelacakan dibangun.

Untuk membuat awalan pesan jejak baru, gunakan perintah set untuk mengatur ulang nilai variabel lingkungan %TRACE_FORMAT_PREFIX%. Contohnya,

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

Perintah ini mengatur awalan pesan pelacakan format berikut:

SourceFile_LineNumber: FunctionName: ProcessID.ThreadID: SystemTime 

Akibatnya, output Tracefmt menggunakan awalan pesan pelacakan baru, seperti yang ditunjukkan pada tampilan berikut:

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 Jika Anda mengatur awalan pelacakan dalam file perintah atau batch, di mana simbol persen mewakili variabel untuk parameter baris perintah, gunakan dua simbol persen berturut-turut untuk variabel awalan. Misalnya, untuk menyertakan waktu sistem dalam awalan, ketik %%4.