struttura EVENT_FILTER_HEADER (evntprov.h)

Definisce i dati di intestazione che devono precedere i dati del filtro definiti nel manifesto della strumentazione.

Sintassi

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

Members

Id

Identificatore che identifica il filtro nel manifesto per un filtro con schema. L'attributo value dell'elemento filtro contiene l'identificatore.

Version

Numero di versione del filtro per un filtro con schema. L'attributo version dell'elemento filter contiene il numero di versione.

Reserved[5]

Riservato

InstanceId

Identificatore che identifica la sessione che ha passato il filtro. ETW imposta questo valore; la sessione deve impostare questo membro su zero.

I provider usano questo valore per impostare il parametro Filter di EventWriteEx per impedire che l'evento venga scritto nella sessione se i dati dell'evento non corrispondono ai criteri di filtro (il provider determina la semantica della modalità di utilizzo dei dati del filtro per determinare se l'evento viene scritto nella sessione).

Size

Dimensione, in byte, di questa intestazione e dei dati del filtro accodati alla fine dell'intestazione.

NextOffset

Offset dall'inizio di questo oggetto filtro all'oggetto filtro successivo. Il valore è zero se non sono presenti altri blocchi di filtro. ETW imposta questo valore; la sessione deve impostare questo membro su zero.

Commenti

I dati del filtro passati al provider includono anche un'intestazione. Di seguito viene illustrato un esempio di come definire un filtro contenente tre numeri interi:

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

MY_FILTER FilterData;

Requisiti

Vedi anche

ENABLE_TRACE_PARAMETERS

EVENT_FILTER_DESCRIPTOR

EnableTrace

EnableTraceEx

EnableTraceEx2