FILTER_FULL_INFORMATION-Struktur (fltuserstructures.h)

Artikel
02/26/2024

Die FILTER_FULL_INFORMATION-Struktur enthält vollständige Informationen für einen Minifiltertreiber.

Syntax

typedef struct _FILTER_FULL_INFORMATION {
  ULONG  NextEntryOffset;
  ULONG  FrameID;
  ULONG  NumberOfInstances;
  USHORT FilterNameLength;
  WCHAR  FilterNameBuffer[1];
} FILTER_FULL_INFORMATION, *PFILTER_FULL_INFORMATION;

Member

NextEntryOffset

Byteoffset des nächsten FILTER_FULL_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.

FrameID

Nullbasierter Index des aktuellen Frames.

NumberOfInstances

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

FilterNameLength

Länge des Minifilternamens in Byte.

FilterNameBuffer[1]

Gibt das erste Zeichen der Filternamenszeichenfolge an. Auf dieses Zeichen folgt im Arbeitsspeicher der rest der Zeichenfolge. Die Länge der Zeichenfolge wird vom FilterNameLength-Element angegeben. Die Zeichenfolge ist Unicode und ist nicht MIT NULL beendet.

Hinweise

Die FILTER_FULL_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.