Contoh 7: Menyesuaikan Awalan Pesan Pelacakan

Setiap pesan pelacakan 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 menunjukkan awalan pesan pelacakan default. Pesan jejak dihasilkan oleh Tracedrv, driver sampel yang diaktifkan jejak di 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 pelacakan baru, gunakan perintah set untuk mereset nilai variabel lingkungan %TRACE_FORMAT_PREFIX%. Misalnya,

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

...

Catatan Jika Anda mengatur awalan pelacakan dalam perintah atau file 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.