FILTER_AGGREGATE_BASIC_INFORMATION-Struktur (fltuserstructures.h)

Artikel
02/29/2024

Die FILTER_AGGREGATE_BASIC_INFORMATION-Struktur enthält grundlegende Informationen für einen Minifilter oder legacy-Filtertreiber.

Syntax

typedef struct _FILTER_AGGREGATE_BASIC_INFORMATION {
  ULONG NextEntryOffset;
  ULONG Flags;
  union {
    struct {
      ULONG  FrameID;
      ULONG  NumberOfInstances;
      USHORT FilterNameLength;
      USHORT FilterNameBufferOffset;
      USHORT FilterAltitudeLength;
      USHORT FilterAltitudeBufferOffset;
    } MiniFilter;
    struct {
      USHORT FilterNameLength;
      USHORT FilterNameBufferOffset;
    } LegacyFilter;
  } Type;
} FILTER_AGGREGATE_BASIC_INFORMATION, *PFILTER_AGGREGATE_BASIC_INFORMATION;

Member

NextEntryOffset

Byteoffset des nächsten FILTER_AGGREGATE_BASIC_INFORMATION Eintrags, wenn mehrere Einträge in einem Puffer vorhanden sind. Dieser Member ist 0(0), wenn keine weiteren Einträge auf diesen Folgen folgen.

Flags

Gibt an, ob der Filtertreiber ein Legacyfilter oder ein Minifilter ist. Dieser Member muss einer der folgenden Werte sein.

Flag	Bedeutung
FLTFL_AGGREGATE_INFO_IS_MINIFILTER	Der Filter ist ein Minifilter. Verwenden Sie den MiniFilter-Teil der Union.
FLTFL_AGGREGATE_INFO_IS_LEGACYFILTER	Der Filter ist ein Legacyfilter. Verwenden Sie den LegacyFilter-Teil der Union.

Type

Type.MiniFilter

Type.MiniFilter.FrameID

Nullbasierter Index des aktuellen Frames.

Type.MiniFilter.NumberOfInstances

Anzahl der Instanzen, die derzeit für den Minifilter vorhanden sind.

Type.MiniFilter.FilterNameLength

Länge des Filternamens in Byte.

Type.MiniFilter.FilterNameBufferOffset

Byteoffset des ersten Zeichens der Filternamenzeichenfolge.

Type.MiniFilter.FilterAltitudeLength

Länge der Minifilterhöhenzeichenfolge in Byte.

Type.MiniFilter.FilterAltitudeBufferOffset

Byteoffset des ersten Zeichens der Minifilterhöhenzeichenfolge.

Type.LegacyFilter

Type.LegacyFilter.FilterNameLength

Länge des Filternamens in Byte.

Type.LegacyFilter.FilterNameBufferOffset

Byteoffset des ersten Zeichens der Filternamenzeichenfolge.

Hinweise

Die FILTER_AGGREGATE_BASIC_INFORMATION-Struktur wird als Parameter an Routinen wie FilterFindFirst, FilterFindNext, FilterGetInformation, FltEnumerateFilterInformation und FltGetFilterInformation übergeben.

Diese Struktur muss an einer LONGLONG-Grenze (8 Byte) ausgerichtet werden. Wenn ein Puffer zwei oder mehr dieser Strukturen enthält, fällt der NextEntryOffset-Wert in jedem Eintrag mit Ausnahme des letzten auf eine 8-Byte-Grenze.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Diese Struktur ist ab Microsoft Windows Server 2003 SP1 und Windows XP SP2 mit Filter-Manager-Rollup verfügbar. Weitere Informationen zum Filter-Manager-Rolluppaket für Windows XP SP2 finden Sie in der Microsoft Knowledge Base im Artikel 914882 "Das Filter-Manager-Rolluppaket für Windows XP SP2".
Kopfzeile	fltuserstructures.h (include FltUser.h, FltKernel.h)