функция обратного вызова PEVENT_TRACE_BUFFER_CALLBACKA (evntrace.h)
Потребители событий 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 будет завершена .
Комментарии
Чтобы указать функцию, которую etW вызывает для доставки статистики буфера, задайте элемент BufferCallbackструктуры EVENT_TRACE_LOGFILE , передаваемой в функцию OpenTrace .
Примеры
Пример реализации функции BufferCallback см. в разделе Извлечение данных событий с помощью MOF.
Примечание
Заголовок evntrace.h определяет PEVENT_TRACE_BUFFER_CALLBACK как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | evntrace.h |