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

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

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

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

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

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

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

Строка форматирования	Описание
%!ФАЙЛ!	Отображает имя исходного файла, из которого было создано сообщение трассировки. Эту переменную можно также использовать в префиксе сообщения трассировки.
%!ФЛАГИ!	Отображает значение флагов трассировки, которые включают сообщение трассировки. Эту переменную можно также использовать в префиксе сообщения трассировки.
%! 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 находит строку в реестре при форматировании сообщений трассировки.
Time
%!delta!	Отображает разницу между двумя значениями времени в миллисекундах. Это значение LONGLONG, отображаемое в формате day~h:m:s .
%! WAITTIME!	Отображает время, затраченное на ожидание завершения, в миллисекундах. Это значение LONGLONG, отображаемое в формате day~h:m:s . Предназначен для использования с %!due!.
%!due!	Отображает время завершения чего-либо в миллисекундах. Это значение LONGLONG, отображаемое в формате day~h:m:s . Предназначен для использования с %! WAITTIME!.
%! TIMESTAMP! %!datetime! %! ВРЕМЯ!	Отображает значение системного времени в определенный момент. Это значения LONGLONG (SINT64), отображаемые в формате SYSTEMTIME. Эти переменные можно использовать для представления разных значений времени в программе и для различения между ними.

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

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

Сеть

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