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

Файл сводного сообщения

  • Статья

Файл сводных сообщений — это текстовый файл, содержащий сведения о трассировке программного обеспечения. Tracefmt создает файл сводного сообщения (SUM) после обработки сообщений в журнале трассировки или сеансе трассировки.

Файл сводных сообщений содержит следующие данные в статистической сводке:

  • Количество обработанных буферов

  • Количество обработанных и потерянных сообщений

  • Затраченное время сеанса трассировки (в микросекундах)

После статистической сводки приведена таблица, состоящая из одной строки для каждого сообщения трассировки, представленного в трассировке. Каждый столбец таблицы содержит следующие сведения о сообщении трассировки:

EventCount
Количество экземпляров сообщения трассировки в трассировке.

EventName
Понятное имя GUID сообщения сообщений трассировки. По умолчанию понятное имя GUID сообщения — это имя каталога, в котором был создан поставщик трассировки, но можно указать альтернативное понятное имя с помощью параметра -p для RUN_WPP или Tracewpp.exe. Дополнительные сведения см. в разделе Параметры Run_WPP. (EventName имеет то же значение, что и переменная %1 в префиксе сообщения трассировки.)

Eventtype
Понятное имя сообщения трассировки. По умолчанию понятное имя сообщения трассировки — это имя исходного файла и номер строки кода, создающего сообщение трассировки. (EventType имеет то же значение, что и переменная %2 в префиксе сообщения трассировки.)

GUID
GUID сообщения сообщений трассировки.

В следующем примере показан файл сводных сообщений для журнала трассировки testtrace.etl, созданного Tracedrv, примером драйвера, инструментированного для трассировки. TraceDrv, пример драйвера, предназначенного для трассировки программного обеспечения, доступен в репозитории примеров драйверов Windows на сайте GitHub.

Files Processed:
d:\DDK Tools\tracetools\testtrace.etl
Total Buffers Processed 4
Total Events  Processed 1718
Total Events  Lost      4
Elapsed Time            122 sec
+---------------------------------------------------------------------------------+
|EventCount    EventName    EventType         Guid                                |
+---------------------------------------------------------------------------------+
|         1    Header       Header            68fdd900-4a3e-11d1-84f4-0000f80464e3|
|      1700    tracedrv     tracedrv_c264     37753236-c81f-505e-d40a-128d3bb2b5ff|
|        17    tracedrv     tracedrv_c258     37753236-c81f-505e-d40a-128d3bb2b5ff|
+---------------------------------------------------------------------------------+

В приведенной выше сводке показано, что Tracedrv создает сообщение заголовка и два сообщения трассировки. Одно сообщение трассировки создается оператором DoTraceMessage в строке 264, а другое — оператором DoTraceMessage в строке 258. В этом журнале трассировки содержится 1700 экземпляров первого сообщения трассировки и 17 экземпляров второго сообщения трассировки.

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