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

Voir aussi

ENABLE_TRACE_PARAMETERS

EVENT_FILTER_DESCRIPTOR

EnableTrace

EnableTraceEx

EnableTraceEx2