функция обратного вызова PEVENT_TRACE_BUFFER_CALLBACKA (evntrace.h)

Статья
08/23/2023

Потребители событий ETW реализуют эту функцию для получения статистики о каждом буфере событий, которые etw доставляет во время сеанса обработки трассировки. EtW вызывает эту функцию после доставки событий для каждого буфера.

Тип PEVENT_TRACE_BUFFER_CALLBACK определяет указатель на эту функцию обратного вызова. BufferCallback — это заполнитель для имени определяемой приложением функции.

Синтаксис

PEVENT_TRACE_BUFFER_CALLBACKA PeventTraceBufferCallbacka;

ULONG PeventTraceBufferCallbacka(
  PEVENT_TRACE_LOGFILEA Logfile
)
{...}

Параметры

Logfile

Указатель на структуру EVENT_TRACE_LOGFILE , содержащую сведения о буфере.

Возвращаемое значение

Чтобы продолжить обработку событий, верните значение TRUE. В противном случае возвращается значение FALSE. Если вернуть значение FALSE , функция ProcessTrace будет завершена .

Примеры

Пример реализации функции BufferCallback см. в разделе Извлечение данных событий с помощью MOF.

Примечание

Заголовок evntrace.h определяет PEVENT_TRACE_BUFFER_CALLBACK как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	evntrace.h

См. также раздел

EVENT_TRACE_LOGFILE

OpenTrace

ProcessTrace

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