Пример 7. Настройка префикса сообщения трассировки

Каждое сообщение трассировки начинается с префикса трассировки, в который входят данные о сообщении трассировки. Формат префикса сообщения трассировки хранится в переменной среды %TRACE_FORMAT_PREFIX%. Изменив значение переменной среды, можно настроить префикс сообщения трассировки, чтобы отобразить данные, необходимые для сообщения трассировки в формате, который наиболее полезен для вас. Переменные в префиксе сообщения трассировки по умолчанию и все переменные, которые можно использовать в префиксе сообщения трассировки, описаны в разделе префикса сообщения трассировки.

На следующем экране показан префикс сообщения трассировки по умолчанию. Сообщения трассировки были созданы Tracedrv, образцом драйвера с поддержкой трассировки в комплекте драйверов 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
...

Формат префикса по умолчанию выглядит следующим образом.

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

который представляет следующие данные:

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

Где значение MessageGUIDFriendlyName по умолчанию — имя каталога, в котором был создан поставщик трассировки.

Чтобы создать новый префикс сообщения трассировки, используйте команду set, чтобы сбросить значение переменной среды %TRACE_FORMAT_PREFIX%. Например

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

Эта команда задает префикс сообщения трассировки в следующем формате:

SourceFile_LineNumber: FunctionName: ProcessID.ThreadID: SystemTime 

В результате выходные данные Tracefmt используют новый префикс сообщения трассировки, как показано на следующем экране:

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

...

Заметка Если вы задаете префикс трассировки в командном или пакетном файле, где символ процента представляет переменную для параметра командной строки, используйте два последовательных символа процента для переменных префикса. Например, чтобы включить системное время в префикс, введите %%4.