EVENT_FILTER_HEADER-Struktur (evntprov.h)

Definiert die Headerdaten, die den Filterdaten vorangestellt werden müssen, die im Instrumentierungsmanifest definiert sind.

Syntax

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

Member

Id

Der Bezeichner, der den Filter im Manifest für einen schematisierten Filter identifiziert. Das value-Attribut des Filterelements enthält den Bezeichner.

Version

Die Versionsnummer des Filters für einen schematisierten Filter. Das Versionsattribute des Filterelements enthält die Versionsnummer.

Reserved[5]

Reserviert

InstanceId

Ein Bezeichner, der die Sitzung identifiziert, die den Filter bestanden hat. ETW legt diesen Wert fest; Die Sitzung muss diesen Member auf 0 festlegen.

Anbieter verwenden diesen Wert, um den Filterparameter von EventWriteEx festzulegen, um zu verhindern, dass das Ereignis in die Sitzung geschrieben wird, wenn die Ereignisdaten nicht den Filterkriterien entsprechen (der Anbieter bestimmt die Semantik, wie die Filterdaten verwendet werden, um zu bestimmen, ob das Ereignis in die Sitzung geschrieben wird).

Size

Die Größe dieses Headers in Bytes und die Filterdaten, die an das Ende dieses Headers angefügt werden.

NextOffset

Der Offset vom Anfang dieses Filterobjekts zum nächsten Filterobjekt. Der Wert ist 0, wenn keine Filterblöcke mehr vorhanden sind. ETW legt diesen Wert fest; Die Sitzung muss diesen Member auf 0 festlegen.

Hinweise

Die Filterdaten, die Sie an den Anbieter übergeben, enthalten auch einen Header. Im folgenden Beispiel wird gezeigt, wie Sie einen Filter definieren, der drei ganze Zahlen enthält:

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

MY_FILTER FilterData;

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Kopfzeile	evntprov.h

Weitere Informationen

ENABLE_TRACE_PARAMETERS

EVENT_FILTER_DESCRIPTOR

EnableTrace

EnableTraceEx

EnableTraceEx2