структура 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 |