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
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 7 [solo app desktop] |
| Server minimo supportato | Windows Server 2008 R2 [solo app desktop] |
| Intestazione | evntprov.h |