İzleme İletisi Ön Eki

Tracefmt, olay izleme günlüğü (.etl) dosyasında ve izleme iletisi biçimi (.tmf) dosyasında depolanan verilerden oluşan her izleme iletisine bir ön ek ekler.

Tracefmt varsayılan olarak belirli veri öğelerini içerir, ancak kullanıcılar FormatMessage ile uyumlu bir ileti tanımı belirten bir dize olan %TRACE_FORMAT_PREFIX% ortam değişkenini değiştirerek öğe ekleyebilir ve kaldırabilir.

Varsayılan izleme iletisi ön ekinin biçimi aşağıdaki gibidir:

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

aşağıdaki ön eki üretir:

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

Her %n değişkeni, aşağıdaki tabloda açıklanan bir parametreyi temsil eder.

Ön ek değişkeni tanımlayıcısı	Değişken türü	Açıklama
%1	string	İzleme mesajının ileti GUID'inin kolay adı. Varsayılan olarak, bir ileti GUID'sinin kolay adı, izleme sağlayıcısının hangi dizinde oluşturulduğunun adıdır. İleti GUID'sinin kolay adını değiştirmek için Tracewpp ile veya RUN_WPP makroyla -p parametresini kullanın. Daha fazla bilgi için bkz. Run_WPP Seçenekleri.
%2	string	Kaynak dosya ve satır numarası. Bu değişken, izleme iletisinin kolay adını temsil eder. Varsayılan olarak, izleme iletisinin kolay adı kaynak dosyanın adı ve izleme iletisini oluşturan kodun satır numarasıdır.
%3	ULONG	İş Parçacığı Kimliği. İzleme iletisini oluşturan iş parçacığını tanımlar.
%4	string	İzleme iletisinin oluşturulduğu zamanın zaman damgası.
%5	string	Çekirdek süresi. İzleme iletisinin oluşturulduğu sırada, CPU işaretlerinde çekirdek modu yönergesi için geçen yürütme süresini görüntüler.
%6	string	Kullanıcı süresi. İzleme iletisinin oluşturulduğu sırada, CPU işaretlerinde kullanıcı modu yönergesi için geçen yürütme süresini görüntüler.
%7	UZUN	Sıra numarası. İzleme iletisinin yerel veya genel sıra numarasını görüntüler. Yalnızca bu izleme oturumu için benzersiz olan yerel sıra numaraları varsayılandır.
%8	ULONG	İşlem Kimliği. İzleme iletisini oluşturan işlemi tanımlar.
%9	ULONG	CPU numarası. İzleme iletisinin oluşturulduğu CPU'sunu tanımlar.
%! FUNC!	string	İşlev adı. İzleme iletisini oluşturan işlevin adını görüntüler.
%!BAYRAKLAR!	string	İzleme iletisini etkinleştiren izleme bayraklarının adını görüntüler. ( DoTraceMessage makrosunun bayrakları ve düzey bağımsız değişkenlerini tersine çevirmesi nedeniyle, DoTraceMessage tarafından oluşturulan iletiler bu alandaki izleme düzeyinin değerini görüntüler.)
%!DÜZEY!	string	İzleme iletisini etkinleştiren izleme düzeyinin değerini görüntüler. ( DoTraceMessage makrosunun bayrakları ve düzey bağımsız değişkenlerini ters çevirmesi nedeniyle, DoTraceMessage tarafından oluşturulan iletiler bu alandaki izleme bayraklarının adını görüntüler.)
%!COMPNAME!	string	Bileşen adı. İzleme iletisini oluşturan sağlayıcının bileşeninin adını görüntüler. Bileşen adı yalnızca izleme kodunda belirtilmişse görünür.
%! ALTCOMP!	string	Alt bileşen adı. Sağlayıcının izleme iletisini oluşturan alt bileşeninin adını görüntüler. Bileşen adı yalnızca izleme kodunda belirtilmişse görünür.

Ünlem işaretleri içindeki simge, değişkenin biçimlendirmesini ve duyarlığı belirten bir dönüştürme karakteridir. Örneğin, %8!04X! dört basamaklı, imzasız onaltılık sayı olarak temsil edilen işlem kimliğini belirtir. Bu dönüştürme karakterleri dahil edilmelidir.

İzleme iletisi ön ekinin öğelerini, sırasını veya biçimlendirmesini değiştirmek için %TRACE_FORMAT_PREFIX% ortam değişkenini kullanın. Örnek için bkz. Örnek 7: İzleme İletisi Ön Ekini Özelleştirme.

TMF dosyasındaki içerik örneği için bkz. tracedrv Örneğinden İzleme İletilerini Biçimlendirme.

Ayrıca -csv parametresi, standart Tracefmt ön ekinin önüne her izleme iletisine yapılandırılmamış, ayrıntılı bir ön ek ekler. CSV ön ekindeki alanların açıklaması için -csvheader parametresini kullanın.