Поделиться через


Что такое строки спецификации расширенного формата WPP

WPP включает предопределенные строки спецификации формата, которые можно использовать в сообщениях трассировки в дополнение к строкам стандартного формата, определенным для printf.

Можно использовать %! ФЛАГИ!, %! FUNC! и %! УРОВЕНЬ! строки в префиксе сообщения трассировки, а также в любой функции или макросе трассировки, например DoTraceMessage.

Другие расширенные строки можно использовать в любой функции трассировки.

Параметры конфигурации по умолчанию для tracewpp

WPP использует "defaultwpp.ini" для параметров конфигурации по умолчанию. Этот ini-файл по умолчанию включен в состав пакета Windows SDK в каталог WppConfig Rev1. Последние сведения о поведении WPP по умолчанию, а также дополнительные сведения о настройке см. в этом INI-файле.

Трассировка программного обеспечения

Строка форматирования Описание
%! ФАЙЛ! Отображает имя исходного файла, из которого было создано сообщение трассировки. Эту переменную также можно использовать в префиксе сообщения трассировки.
%! ФЛАГИ! Отображает значение флагов трассировки , включающих сообщение трассировки. Эту переменную также можно использовать в префиксе сообщения трассировки.
%! FUNC! Отображает функцию, создающую сообщение трассировки. Эту переменную также можно использовать в префиксе сообщения трассировки.
%! УРОВЕНЬ! Отображает имя уровня трассировки , который включает сообщение трассировки. Эту переменную также можно использовать в префиксе сообщения трассировки.
%! ЛИНИИ! Отображает номер строки в коде, создающей префикс трассировки. Эту переменную также можно использовать в префиксе сообщения трассировки.

Общее использование

Строка форматирования Описание
%!bool! Отображает значение TRUE или FALSE
%!irql! Отображает имя текущего IRQL.
%!sid! Представляет указатель на идентификатор безопасности (pSID). Отображает идентификатор безопасности.
Guid
%! GUID! Представляет указатель на GUID (pGUID). Отображает guid, на который указывает.
%! CLSID! Идентификатор класса. Представляет указатель на ИДЕНТИФИКАТОР класса GUID. Отображает строку, связанную с GUID. WPP находит строку в реестре при форматировании сообщений трассировки.
%! LIBID! Библиотека типов. Представляет GUID библиотеки типов COM. Отображает строку, связанную с GUID. WPP находит строку в реестре при форматировании сообщений трассировки.
%! IID! Идентификатор интерфейса. Представляет указатель на GUID идентификатора интерфейса. Отображает строку, связанную с GUID. WPP находит строку в реестре при форматировании сообщений трассировки.
Время
%!delta! Отображает разницу между двумя значениями времени в миллисекундах. Это значение LONGLONG, которое отображается в формате day~h:m:s .
%! WAITTIME! Отображает время, затраченное на ожидание завершения, в миллисекундах. Это значение LONGLONG, которое отображается в формате day~h:m:s . Предназначен для использования с %!due!.
%!срок! Отображает время выполнения в миллисекундах. Это значение LONGLONG, которое отображается в формате day~h:m:s . Предназначен для использования с %! ВРЕМЯ ОЖИДАНИЯ!.
%! TIMESTAMP!
%!datetime!
%! ВРЕМЯ!
Отображает значение системного времени в определенный момент. Это значения LONGLONG (SINT64), отображаемые в формате SYSTEMTIME.
Эти переменные можно использовать для представления различных значений времени в программе и для их различения.

Коды возврата

Строка форматирования Описание
%! СТАТУС! Представляет значение состояния и отображает строку, связанную с кодом состояния.
%! WINERROR! Представляет код ошибки Windows и отображает строку, связанную с ошибкой.
%! HRESULT! Представляет ошибку или предупреждение и отображает код в формате HRESULT.

Сеть

Строка форматирования Описание
%! IPADDR! Представляет указатель на IP-адрес. Отображает IP-адрес.
%! ПОРТ! Отображает номер порта.