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 |