Заголовок evntrace.h

Этот заголовок используется несколькими технологиями. Дополнительные сведения можно найти здесь

• Трассировка событий
• Справочник по драйверамKernel-Mode

evntrace.h содержит следующие интерфейсы программирования:

Functions

CloseTrace Функция CloseTrace закрывает сеанс обработки трассировки, созданный с помощью OpenTrace.
ControlTraceA Функция ControlTraceA (ANSI) (evntrace.h) очищает, запрашивает, обновляет или останавливает указанный сеанс трассировки событий.
ControlTraceW Функция ControlTraceW (Юникод) (evntrace.h) очищает, запрашивает, обновляет или останавливает указанный сеанс трассировки событий.
CreateTraceInstanceId Поставщик событий На основе RegisterTraceGuids ("Классический") использует функцию CreateTraceInstanceId для создания уникального идентификатора транзакции и сопоставления его с дескриптором регистрации. Затем поставщик может использовать идентификатор транзакции при вызове функции TraceEventInstance.
EnableTrace Контроллер сеанса трассировки вызывает EnableTrace, чтобы настроить, как поставщик событий ETW регистрирует события в сеанс трассировки. Функция EnableTraceEx2 заменяет эту функцию.
EnableTraceEx Контроллер сеанса трассировки вызывает EnableTraceEx, чтобы настроить, как поставщик событий ETW регистрирует события в сеанс трассировки. Функция EnableTraceEx2 заменяет эту функцию.
EnableTraceEx2 Контроллер сеанса трассировки вызывает EnableTraceEx2, чтобы настроить, как поставщик событий ETW регистрирует события в сеанс трассировки.
ПеречислениеTraceGuids Извлекает сведения о поставщиках трассировки событий, работающих на компьютере. Функция EnumerateTraceGuidsEx заменяет эту функцию.
ПеречислениеTraceGuidsEx Извлекает сведения о поставщиках трассировки событий, работающих на компьютере.
FlushTraceA Функция FlushTraceA (ANSI) (evntrace.h) приводит к тому, что сеанс трассировки событий немедленно доставляет буферированные события для указанного сеанса.
FlushTraceW Функция FlushTraceW (Юникод) (evntrace.h) приводит к тому, что сеанс трассировки событий немедленно доставляет буферные события для указанного сеанса.
GetTraceEnableFlags Поставщик событий На основе RegisterTraceGuids ("Классический") использует функцию GetTraceEnableFlags для получения флагов, указанных контроллером трассировки, чтобы указать, какая категория событий для трассировки. Поставщики вызывают эту функцию из функции ControlCallback.
GetTraceEnableLevel Поставщик событий На основе RegisterTraceGuids ("Классический") использует функцию GetTraceEnableLevel для получения уровня включения, заданного контроллером трассировки, чтобы указать, какой уровень событий для трассировки. Поставщики вызывают эту функцию из функции ControlCallback.
GetTraceLoggerHandle Поставщик событий На основе RegisterTraceGuids ("Классический") использует функцию GetTraceLoggerHandle для получения дескриптора сеанса трассировки событий, в который он должен записывать события. Поставщики вызывают эту функцию из функции ControlCallback.
OpenTraceA Функция OpenTraceA (ANSI) (evntrace.h) открывает дескриптор трассировки ETW для использования событий из сеанса трассировки ETW или файла журнала ETW.
OpenTraceFromBufferStream Создает сеанс обработки трассировки, который не подключен непосредственно к файлу или активному сеансу.
OpenTraceFromFile Создает сеанс обработки трассировки для обработки ETL-файла Tracelog.
OpenTraceFromRealTimeLogger Открывает дескриптор трассировки ETW для использования событий из сеанса трассировки в режиме реального времени или файла журнала ETW.
OpenTraceFromRealTimeLoggerWithAllocationOptions Создает сеанс обработки трассировки, подключенный к активному сеансу ETW в режиме реального времени.
OpenTraceW Функция OpenTraceW (Юникод) (evntrace.h) открывает дескриптор трассировки ETW для использования событий из сеанса трассировки ETW в режиме реального времени или файла журнала ETW.
ProcessTrace Предоставляет события из одного или нескольких сеансов обработки трассировки потребителю.
ProcessTraceAddBufferToBufferStream Предоставляет буфер трассировки ETW сеансу обработки, созданному OpenTraceFromBufferStream.
ProcessTraceBufferDecrementReference Освобождает ссылку на буфер, добавленный ProcessTraceBufferIncrementReference.
ProcessTraceBufferIncrementReference Вызывается во время буфераCallback в предоставленном буфере, чтобы предотвратить освобождение его до тех пор, пока вызывающий объект не будет выполнен.
QueryAllTracesA Функция QueryAllTracesA (ANSI) (evntrace.h) извлекает свойства и статистику для всех сеансов трассировки событий, которые вызывающий может запрашивать.
QueryAllTracesW Функция QueryAllTracesW (Юникод) (evntrace.h) извлекает свойства и статистику для всех сеансов трассировки событий, которые вызывающий объект может запрашивать.
QueryTraceA Функция QueryTraceA (ANSI) (evntrace.h) извлекает параметры свойства и статистику сеанса для указанного сеанса трассировки событий.
QueryTraceProcessingHandle Извлекает сведения о сеансе обработки трассировки ETW, открытом OpenTrace.
QueryTraceW Функция QueryTraceW (Юникод) (evntrace.h) извлекает параметры свойства и статистику сеанса для указанного сеанса трассировки событий.
RegisterTraceGuidsA Функция RegisterTraceGuidsA (ANSI) (evntrace.h) является устаревшей функцией, а новый код должен использовать предоставленный альтернативный вариант.
RegisterTraceGuidsW Функция RegisterTraceGuidsW (Юникод) (evntrace.h) является устаревшей функцией, и новый код должен использовать предоставленную альтернативу.
RemoveTraceCallback Функция RemoveTraceCallback останавливает функцию EventCallback от получения событий для класса трассировки событий. Эта функция устарела.
SetTraceCallback Функция SetTraceCallback указывает функцию EventCallback для обработки событий для указанного класса трассировки событий. Эта функция устарела.
StartTraceA Функция StartTrace запускает сеанс трассировки событий. (ANSI)
StartTraceW Функция StartTrace запускает сеанс трассировки событий. (Юникод)
StopTraceA Функция StopTraceA (ANSI) (evntrace.h) останавливает указанный сеанс трассировки событий. Функция ControlTrace заменяет эту функцию.
StopTraceW Функция StopTraceW (Юникод) (evntrace.h) останавливает указанный сеанс трассировки событий. Функция ControlTrace заменяет эту функцию.
TraceConfigureLastBranchRecord Настраивает трассировку событий для сеанса Windows (ETW) для создания событий трассировки last Branch Record (LBR) в ответ на указанные события активации.
Traceevent Поставщик событий На основе RegisterTraceGuids ("Классический") использует функцию TraceEvent для отправки структурированного события в сеанс трассировки событий.
TraceEventInstance Поставщик событий На основе RegisterTraceGuids ("Классический") использует функцию TraceEventInstance для отправки структурированного события в сеанс трассировки событий с идентификатором экземпляра.
TraceMessage Поставщик событий На основе RegisterTraceGuids ("Классический") использует функцию TraceMessage для отправки события на основе сообщений (WPP на основе TMF) в сеанс трассировки событий.
TraceMessageVa Поставщик событий на основе RegisterTraceGuids ("Классический") использует функцию TraceMessageVa для отправки события на основе сообщений (WPP на основе TMF) в сеанс трассировки событий с помощью параметров va_list.
TraceQueryInformation Предоставляет сведения о сеансе трассировки событий.
TraceSetInformation Настраивает параметры сеанса трассировки событий.
Отмена регистрацииTraceGuids Отменяет регистрацию поставщика трассировки событий трассировки событий ETW, зарегистрированного с помощью RegisterTraceGuids, отменяет регистрацию поставщика трассировки событий ETW (классический) (Windows 2000 стилей).
UpdateTraceA Функция UpdateTraceA (ANSI) (evntrace.h) обновляет параметр свойства указанного сеанса трассировки событий.
UpdateTraceW Функция UpdateTraceW (Юникод) (evntrace.h) обновляет параметр свойства указанного сеанса трассировки событий.

Функции обратного вызова

PETW_BUFFER_CALLBACK Определение функции для bufferCallback, которое будет вызываться ProcessTrace.
PETW_BUFFER_COMPLETION_CALLBACK Определение функции для обратного вызова, которое будет запущено при завершении ProcessTraceAddBufferToBufferStream с буфером. Этот обратный вызов обычно должен освободить буфер соответствующим образом.
PEVENT_CALLBACK Потребители событий ETW реализуют этот обратный вызов для получения событий из сеанса обработки трассировки. Обратный вызов EventRecordCallback заменяет этот обратный вызов.
PEVENT_RECORD_CALLBACK Потребители событий ETW реализуют этот обратный вызов для получения событий из сеанса обработки трассировки. Тип PEVENT_RECORD_CALLBACK определяет указатель на эту функцию обратного вызова. EventRecordCallback — это заполнитель для имени функции, определяемой приложением.
PEVENT_TRACE_BUFFER_CALLBACKA Функция PEVENT_TRACE_BUFFER_CALLBACKA (ANSI) (evntrace.h) получает статистику по каждому буферу событий, которые etW отправляет во время сеанса обработки трассировки.
PEVENT_TRACE_BUFFER_CALLBACKW Функция PEVENT_TRACE_BUFFER_CALLBACKW (Юникод) (evntrace.h) получает статистику о каждом буфере событий, которые etW отправляет во время сеанса обработки трассировки.
WMIDPREQUEST Поставщик событий На основе RegisterTraceGuids ("Классический") реализует эту функцию для получения уведомлений от контроллеров. Тип WMIDPREQUEST определяет указатель на эту функцию обратного вызова. ControlCallback — это заполнитель для имени определяемой приложением функции.

Structures

CLASSIC_EVENT_ID Определяет событие ядра, для которого требуется включить трассировку стека вызовов.
ENABLE_TRACE_PARAMETERS Содержит сведения, используемые для включения поставщика через EnableTraceEx2.
ENABLE_TRACE_PARAMETERS_V1 Содержит сведения, используемые для включения поставщика через EnableTraceEx2. Эта структура устарела.
ETW_BUFFER_CALLBACK_INFORMATION Предоставляется буферCallback в качестве параметра ConsumerInfo и предоставляет сведения о текущем сеансе обработки.
ETW_BUFFER_CONTEXT Предоставляет сведения о контексте события.
ETW_BUFFER_HEADER Структура заголовка буфера ETW.
ETW_OPEN_TRACE_OPTIONS Предоставляет параметры конфигурации для функций OpenTraceFromBufferStream, OpenTraceFromFile, OpenTraceFromRealTimeLogger, OpenTraceFromRealTimeLoggerWithAllocationOptions.
ETW_TRACE_PARTITION_INFORMATION Содержит сведения о секции, извлекаемые из трассировки etw.
EVENT_INSTANCE_HEADER Структура EVENT_INSTANCE_HEADER содержит стандартные сведения о трассировке событий, общие для всех событий, написанных TraceEventInstance.
EVENT_INSTANCE_INFO Структура EVENT_INSTANCE_INFO сопоставляет уникальный идентификатор транзакции с зарегистрированным классом трассировки событий для TraceEventInstance.
EVENT_TRACE Структура EVENT_TRACE используется для доставки сведений о событиях потребителю трассировки событий.
EVENT_TRACE_HEADER Структура EVENT_TRACE_HEADER содержит стандартную информацию трассировки событий, общую для всех событий, написанных TraceEvent.
EVENT_TRACE_LOGFILEA Структура EVENT_TRACE_LOGFILEA (ANSI) (evntrace.h) хранит сведения о источнике данных трассировки.
EVENT_TRACE_LOGFILEW Структура EVENT_TRACE_LOGFILEW (Юникод) (evntrace.h) хранит сведения о источнике данных трассировки.
EVENT_TRACE_PROPERTIES Структура EVENT_TRACE_PROPERTIES содержит сведения о сеансе трассировки событий и используется с ТАКИМИ API, как StartTrace и ControlTrace.
EVENT_TRACE_PROPERTIES_V2 Структура EVENT_TRACE_PROPERTIES_V2 содержит сведения о сеансе трассировки событий и используется с ТАКИМИ API, как StartTrace и ControlTrace.
MOF_FIELD Можно использовать структуры MOF_FIELD для добавления данных событий в структуры EVENT_TRACE_HEADER или EVENT_INSTANCE_HEADER.
TRACE_CONTEXT_REGISTER_INFO Определяет набор регистров для ведения журнала при включении трассировки регистра контекста.
TRACE_ENABLE_INFO Определяет сеанс и сведения, используемые сеансом для включения поставщика.
TRACE_GUID_INFO Возвращается перечислением EnumerateTraceGuidsEx. Определяет заголовок списка сеансов, включающих поставщика.
TRACE_GUID_PROPERTIES Возвращается перечислением EnumerateTraceGuids. Содержит сведения о поставщике трассировки событий.
TRACE_GUID_REGISTRATION Используется с RegisterTraceGuids для регистрации классов трассировки событий.
TRACE_LOGFILE_HEADER Структура TRACE_LOGFILE_HEADER содержит сведения о сеансе трассировки событий и его событиях.
TRACE_PERIODIC_CAPTURE_STATE_INFO Используется с TraceQueryInformation и TraceSetInformation для получения или задания сведений, связанных с периодическим состоянием захвата.
TRACE_PROVIDER_INSTANCE_INFO Определяет экземпляр GUID поставщика.
TRACE_VERSION_INFO Определяет сведения о версии сеанса TraceLogging.

Enumerations

ETW_CONTEXT_REGISTER_TYPES Указывает набор регистров, собираемых при включении трассировки регистра контекста.
ETW_PROCESS_HANDLE_INFO_TYPE Указывает операцию, которая будет выполняться в сеансе обработки трассировки.
ETW_PROCESS_TRACE_MODES Задает поддерживаемые режимы трассировки процессов.
TRACE_QUERY_INFO_CLASS Используется с ПеречислениемTraceGuidsEx и TraceSetInformation для указания типа сведений трассировки.