FILTER_FULL_INFORMATION structure (fltuserstructures.h)

Article
02/29/2024

La structure FILTER_FULL_INFORMATION contient des informations complètes pour un pilote minifilter.

Syntaxe

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

Membres

NextEntryOffset

Décalage d’octets de l’entrée FILTER_FULL_INFORMATION suivante, si plusieurs entrées sont présentes dans une mémoire tampon. Ce membre est égal à zéro si aucune autre entrée ne suit celle-ci.

FrameID

Index de base zéro de l’image actuelle.

NumberOfInstances

Nombre d’instances qui existent actuellement pour ce minifiltre.

FilterNameLength

Longueur, en octets, du nom du minifiltre.

FilterNameBuffer[1]

Spécifie le premier caractère de la chaîne de nom de filtre. Ce caractère est suivi en mémoire par le reste de la chaîne. La longueur de la chaîne est spécifiée par le membre FilterNameLength . La chaîne est Unicode et n’est pas terminée par NULL.

Remarques

La structure FILTER_FULL_INFORMATION est passée en tant que paramètre à des routines telles que FilterFindFirst, FilterFindNext, FilterGetInformation, FltEnumerateFilterInformation et FltGetFilterInformation.

Cette structure doit être alignée sur une limite LONGLONG (8 octets). Si une mémoire tampon contient au moins deux de ces structures, la valeur NextEntryOffset dans chaque entrée, à l’exception de la dernière, se situe sur une limite de 8 octets.