Share via

структура EVENT_FILTER_HEADER (evntprov.h)

  • Статья

Определяет данные заголовка, которые должны предшествовать данным фильтра, определенным в манифесте инструментирования.

Синтаксис

typedef struct _EVENT_FILTER_HEADER {
  USHORT    Id;
  UCHAR     Version;
  UCHAR     Reserved[5];
  ULONGLONG InstanceId;
  ULONG     Size;
  ULONG     NextOffset;
} EVENT_FILTER_HEADER, *PEVENT_FILTER_HEADER;

Члены

Id

Идентификатор, идентифицирующий фильтр в манифесте для схематизированного фильтра. Атрибут value элемента фильтра содержит идентификатор.

Version

Номер версии фильтра для схематизированного фильтра. Атрибут version элемента фильтра содержит номер версии.

Reserved[5]

Зарезервировано

InstanceId

Идентификатор, определяющий сеанс, прошедший фильтр. EtW задает это значение; сеанс должен присвоить этому члену нулевое значение.

Поставщики используют это значение, чтобы задать параметр Filterобъекта EventWriteEx , чтобы предотвратить запись события в сеанс, если данные события не соответствуют критериям фильтра (поставщик определяет семантику использования данных фильтра при определении того, записывается ли событие в сеанс).

Size

Размер (в байтах) этого заголовка и данных фильтра, которые добавляются в конец этого заголовка.

NextOffset

Смещение от начала этого объекта фильтра к следующему объекту фильтра. Значение равно нулю, если больше нет блоков фильтра. EtW задает это значение; сеанс должен присвоить этому члену нулевое значение.

Комментарии

Данные фильтра, передаваемые поставщику, также содержат заголовок. Ниже приведен пример определения фильтра, содержащего три целых числа:

struct _MY_FILTER {
    EVENT_FILTER_HEADER FilterHeader;
    ULONG Int1;
    ULONG Int2;
    ULONG Int3;
} MY_FILTER, *MY_FILTER;

MY_FILTER FilterData;

Требования

Требование Значение
Минимальная версия клиента Windows 7 [только классические приложения]
Минимальная версия сервера Windows Server 2008 R2 [только классические приложения]
Верхняя часть evntprov.h

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

ENABLE_TRACE_PARAMETERS

EVENT_FILTER_DESCRIPTOR

EnableTrace

EnableTraceEx

EnableTraceEx2