Örnek 7: İzleme İletisi Ön Ekini Özelleştirme

Her izleme iletisi, izleme iletisiyle ilgili verilerden oluşan bir izleme iletisi ön eki ile başlar. İzleme iletisi ön ekinin biçimi %TRACE_FORMAT_PREFIX% ortam değişkeninde depolanır. Ortam değişkeninin değerini değiştirerek, izleme iletisiyle ilgili ihtiyacınız olan verileri sizin için en kullanışlı biçimde görüntülemek için izleme iletisi ön ekini özelleştirebilirsiniz. Varsayılan izleme iletisi ön ekindeki değişkenler ve izleme iletisi ön ekinde kullanabileceğiniz tüm değişkenler, İzleme İletisi Ön Eki konusunda açıklanmıştır.

Aşağıdaki görüntüde varsayılan izleme iletisi ön eki gösterilmektedir. İzleme iletileri, Windows Sürücü Seti'ndeki (WDK) izleme özellikli örnek sürücü Tracedrv tarafından oluşturuldu.

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

Varsayılan ön ekin biçimi aşağıdaki gibidir.

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

aşağıdaki verileri temsil eder:

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

burada MessageGUIDFriendlyName varsayılan olarak izleme sağlayıcısının oluşturulduğu dizinin adıdır.

Yeni bir izleme iletisi ön eki oluşturmak için set komutunu kullanarak %TRACE_FORMAT_PREFIX% ortam değişkeninin değerini sıfırlayın. Örneğin

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

Bu komut, izleme iletisi ön ekini aşağıdaki biçimde ayarlar:

SourceFile_LineNumber: FunctionName: ProcessID.ThreadID: SystemTime 

Sonuç olarak Tracefmt çıktısı, aşağıdaki ekranda gösterildiği gibi yeni izleme iletisi ön ekini kullanır:

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

...

Not İzleme ön ekini, yüzde simgesinin komut satırı parametresi için bir değişkeni temsil ettiği bir komut veya toplu iş dosyasında ayarlıysanız, ön ek değişkenleri için ardışık iki yüzde simgesi kullanın. Örneğin, sistem saatini ön eke eklemek için %%4yazın.