structure FILTER_AGGREGATE_BASIC_INFORMATION (fltuserstructures.h)

Article
03/08/2024

La structure FILTER_AGGREGATE_BASIC_INFORMATION contient des informations de base pour un minifiltre ou un pilote de filtre hérité.

Syntaxe

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;

Membres

NextEntryOffset

Décalage d’octet de l’entrée FILTER_AGGREGATE_BASIC_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_AGGREGATE_INFO_IS_MINIFILTER	Le filtre est un minifiltre : utilisez la partie MiniFilter de l’union.
FLTFL_AGGREGATE_INFO_IS_LEGACYFILTER	Le filtre est un filtre hérité : utilisez la partie LegacyFilter de l’union.

Type

Type.MiniFilter

Type.MiniFilter.FrameID

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

Type.MiniFilter.NumberOfInstances

Nombre d’instances qui existent actuellement pour le minifiltre.

Type.MiniFilter.FilterNameLength

Longueur, en octets, du nom du filtre.

Type.MiniFilter.FilterNameBufferOffset

Décalage d’octet du premier caractère de la chaîne de nom de filtre.

Type.MiniFilter.FilterAltitudeLength

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

Type.MiniFilter.FilterAltitudeBufferOffset

Décalage d’octet du premier caractère de la chaîne d’altitude du minifiltre.

Type.LegacyFilter

Type.LegacyFilter.FilterNameLength

Longueur, en octets, du nom du filtre.

Type.LegacyFilter.FilterNameBufferOffset

Décalage d’octet du premier caractère de la chaîne de nom de filtre.

Remarques

La structure FILTER_AGGREGATE_BASIC_INFORMATION est transmise 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 de chaque entrée, à l’exception de la dernière, se situe sur une limite de 8 octets.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Cette structure est disponible à partir de Microsoft Windows Server 2003 SP1 et De Windows XP SP2 avec correctif cumulatif du gestionnaire de filtres. Pour plus d’informations sur le package cumulatif du gestionnaire de filtres pour Windows XP SP2, consultez l’article 914882« Package cumulatif du gestionnaire de filtres pour Windows XP SP2 » dans la Base de connaissances Microsoft.
En-tête	fltuserstructures.h (include FltUser.h, FltKernel.h)