structure FILTER_AGGREGATE_STANDARD_INFORMATION (fltuserstructures.h)

Article
02/26/2024

La structure FILTER_AGGREGATE_STANDARD_INFORMATION contient des informations sur un minifiltre ou un pilote de filtre hérité.

Syntaxe

typedef struct _FILTER_AGGREGATE_STANDARD_INFORMATION {
  ULONG NextEntryOffset;
  ULONG Flags;
  union {
    struct {
      ULONG  Flags;
      ULONG  FrameID;
      ULONG  NumberOfInstances;
      USHORT FilterNameLength;
      USHORT FilterNameBufferOffset;
      USHORT FilterAltitudeLength;
      USHORT FilterAltitudeBufferOffset;
    } MiniFilter;
    struct {
      ULONG  Flags;
      USHORT FilterNameLength;
      USHORT FilterNameBufferOffset;
      USHORT FilterAltitudeLength;
      USHORT FilterAltitudeBufferOffset;
    } LegacyFilter;
  } Type;
} FILTER_AGGREGATE_STANDARD_INFORMATION, *PFILTER_AGGREGATE_STANDARD_INFORMATION;

Membres

NextEntryOffset

Décalage d’octet de l’entrée FILTER_AGGREGATE_STANDARD_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.

Flags

Indique si le pilote de filtre est un filtre hérité ou un minifiltre. Ce membre doit être l’une des valeurs suivantes.

Indicateur	Signification
FLTFL_ASI_IS_MINIFILTER	Le filtre est un minifiltre : utilisez la partie MiniFilter de l’union.
FLTFL_ASI_IS_LEGACYFILTER	Le filtre est un filtre hérité : utilisez la partie LegacyFilter de l’union.

Type

Type.MiniFilter

Variable de structure imbriquée avec les membres suivants :

Type.MiniFilter.Flags

Aucun indicateur n’est actuellement défini pour ce membre.

Type.MiniFilter.FrameID

Index de base zéro utilisé pour identifier l’image du gestionnaire de filtres dans laquelle se trouve le minifiltre.

Type.MiniFilter.NumberOfInstances

Nombre d’instances qui existent actuellement pour le minifiltre.

Type.MiniFilter.FilterNameLength

Longueur, en octets, de la chaîne de nom de minifiltre.

Type.MiniFilter.FilterNameBufferOffset

Décalage d’octet (par rapport au début de la structure) du premier caractère de la chaîne de nom du minifiltre Unicode. La chaîne n’est pas terminée par NULL.

Type.MiniFilter.FilterAltitudeLength

Longueur, en octets, de la chaîne d’altitude du minifiltre.

Type.MiniFilter.FilterAltitudeBufferOffset

Décalage d’octet (par rapport au début de la structure) du premier caractère de la chaîne d’altitude du minifiltre Unicode. La chaîne n’est pas terminée par NULL.

Type.LegacyFilter

Variable de structure imbriquée avec les membres suivants :

Type.LegacyFilter.Flags

Aucun indicateur n’est actuellement défini pour ce membre.

Type.LegacyFilter.FilterNameLength

Longueur, en octets, de la chaîne de nom de filtre héritée.

Type.LegacyFilter.FilterNameBufferOffset

Décalage d’octet (par rapport au début de la structure) du premier caractère de la chaîne de nom de filtre hérité Unicode. La chaîne n’est pas terminée par NULL.

Type.LegacyFilter.FilterAltitudeLength

Longueur, en octets, de la chaîne d’altitude de filtre héritée.

Type.LegacyFilter.FilterAltitudeBufferOffset

Décalage d’octet (par rapport au début de la structure) du premier caractère de la chaîne d’altitude du filtre unicode hérité. La chaîne n’est pas terminée par NULL.

À compter de Windows Vista, les altitudes sont attribuées aux pilotes de filtre hérités en fonction du groupe d’ordre de charge du pilote. Cela garantit que les pilotes de minifiltre seront correctement superposés et inférieurs aux pilotes de filtre hérités, même si un ou plusieurs des pilotes de filtre sont chargés dans le désordre.

Remarques

La structure FILTER_AGGREGATE_STANDARD_INFORMATION peut être allouée à partir d’un pool paginé ou non paginé. Cette structure est transmise en tant que paramètre à des routines telles que :

La structure FILTER_AGGREGATE_STANDARD_INFORMATION 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 se situe sur une limite de 8 octets.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Cette structure est disponible à partir de Windows Vista.
En-tête	fltuserstructures.h (include FltUser.h, FltKernel.h)