EVENT_FILTER_HEADER structure (evntprov.h)
Définit les données d’en-tête qui doivent précéder les données de filtre définies dans le manifeste d’instrumentation.
Syntaxe
typedef struct _EVENT_FILTER_HEADER {
USHORT Id;
UCHAR Version;
UCHAR Reserved[5];
ULONGLONG InstanceId;
ULONG Size;
ULONG NextOffset;
} EVENT_FILTER_HEADER, *PEVENT_FILTER_HEADER;
Membres
Id
Identificateur qui identifie le filtre dans le manifeste pour un filtre schématisé. L’attribut value de l’élément filter contient l’identificateur.
Version
Numéro de version du filtre pour un filtre schématisé. L’attribut version de l’élément filter contient le numéro de version.
Reserved[5]
Réservé
InstanceId
Identificateur qui identifie la session qui a passé le filtre. ETW définit cette valeur ; la session doit définir ce membre sur zéro.
Les fournisseurs utilisent cette valeur pour définir le paramètre Filter de EventWriteEx afin d’empêcher l’écriture de l’événement dans la session si les données d’événement ne correspondent pas aux critères de filtre (le fournisseur détermine la sémantique de l’utilisation des données de filtre pour déterminer si l’événement est écrit dans la session).
Size
Taille, en octets, de cet en-tête et des données de filtre ajoutées à la fin de cet en-tête.
NextOffset
Décalage entre le début de cet objet de filtre et l’objet de filtre suivant. La valeur est égale à zéro s’il n’y a plus de blocs de filtre. ETW définit cette valeur ; la session doit définir ce membre sur zéro.
Remarques
Les données de filtre que vous passez au fournisseur incluent également un en-tête. Voici un exemple de définition d’un filtre contenant trois entiers :
struct _MY_FILTER {
EVENT_FILTER_HEADER FilterHeader;
ULONG Int1;
ULONG Int2;
ULONG Int3;
} MY_FILTER, *MY_FILTER;
MY_FILTER FilterData;
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 7 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 R2 [applications de bureau uniquement] |
| En-tête | evntprov.h |