Przykład 7. Dostosowywanie prefiksu komunikatu śledzenia

Każdy komunikat śledzenia rozpoczyna się od prefiksu komunikatu śledzenia składającego się z danych dotyczących komunikatu śledzenia. Format prefiksu komunikatu śledzenia jest przechowywany w zmiennej środowiskowej %TRACE_FORMAT_PREFIX%. Zmieniając wartość zmiennej środowiskowej, można dostosować prefiks komunikatu śledzenia, aby wyświetlić potrzebne dane dotyczące komunikatu śledzenia w formacie, który jest najbardziej przydatny. Zmienne w domyślnym prefiksie komunikatu śledzenia i wszystkie zmienne, których można użyć w prefiksie komunikatu śledzenia, są opisane w temacie Trace Message Prefix (Prefiks komunikatu śledzenia).

Poniższy ekran przedstawia domyślny prefiks komunikatu śledzenia. Komunikaty śledzenia zostały wygenerowane przez tracedrv, przykładowy sterownik z włączoną obsługą śledzenia w zestawie sterowników systemu Windows (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 domyślnego prefiksu jest następujący.

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

które reprezentują następujące dane:

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

gdzie MessageGUIDFriendlyName jest domyślnie nazwą katalogu, w którym skompilowano dostawcę śladu.

Aby utworzyć nowy prefiks komunikatu śledzenia, użyj polecenia set , aby zresetować wartość zmiennej środowiskowej %TRACE_FORMAT_PREFIX%. Na przykład

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

To polecenie ustawia prefiks komunikatu śledzenia w następującym formacie:

SourceFile_LineNumber: FunctionName: ProcessID.ThreadID: SystemTime 

W rezultacie dane wyjściowe narzędzia Tracefmt używają nowego prefiksu komunikatu śledzenia, jak pokazano na poniższym ekranie:

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

...

Uwaga Jeśli ustawiasz prefiks śledzenia w pliku polecenia lub wsadowym, gdzie symbol procenta reprezentuje zmienną dla parametru wiersza polecenia, użyj dwóch kolejnych symboli procenta dla zmiennych prefiksu. Aby na przykład uwzględnić czas systemowy w prefiksie, wpisz %%4.