struttura FILTER_AGGREGATE_BASIC_INFORMATION (fltuserstructures.h)

Articolo
03/05/2024

La struttura FILTER_AGGREGATE_BASIC_INFORMATION contiene informazioni di base per un minifilter o un driver di filtro legacy.

Sintassi

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;

Members

NextEntryOffset

Offset di byte della voce di FILTER_AGGREGATE_BASIC_INFORMATION successiva, se sono presenti più voci in un buffer. Questo membro è zero se nessun'altra voce segue questa.

Flags

Indica se il driver di filtro è un filtro legacy o un minifilter. Questo membro deve essere uno dei valori seguenti.

Contrassegno	Significato
FLTFL_AGGREGATE_INFO_IS_MINIFILTER	Il filtro è un minifiltro: usare la parte MiniFilter dell'unione.
FLTFL_AGGREGATE_INFO_IS_LEGACYFILTER	Il filtro è un filtro legacy: usare la parte LegacyFilter dell'unione.

Type

Type.MiniFilter

Type.MiniFilter.FrameID

Indice in base zero del frame corrente.

Type.MiniFilter.NumberOfInstances

Numero di istanze attualmente esistenti per il minifilter.

Type.MiniFilter.FilterNameLength

Lunghezza, in byte, del nome del filtro.

Type.MiniFilter.FilterNameBufferOffset

Offset di byte del primo carattere della stringa del nome del filtro.

Type.MiniFilter.FilterAltitudeLength

Lunghezza, in byte, della stringa di altitudine del minifiltro.

Type.MiniFilter.FilterAltitudeBufferOffset

Offset di byte del primo carattere della stringa di altitudine minifilter.

Type.LegacyFilter

Type.LegacyFilter.FilterNameLength

Lunghezza, in byte, del nome del filtro.

Type.LegacyFilter.FilterNameBufferOffset

Offset di byte del primo carattere della stringa del nome del filtro.

Commenti

La struttura FILTER_AGGREGATE_BASIC_INFORMATION viene passata come parametro a routine come FilterFindFirst, FilterFindNext, FilterGetInformation, FltEnumerateFilterInformation e FltGetFilterInformation.

Questa struttura deve essere allineata su un limite di LONGLONG (8 byte). Se un buffer contiene due o più di queste strutture, il valore NextEntryOffset in ogni voce, ad eccezione dell'ultimo, cade su un limite di 8 byte.

Requisiti

Requisito	Valore
Client minimo supportato	Questa struttura è disponibile a partire da Microsoft Windows Server 2003 SP1 e Windows XP SP2 con rollup del gestore filtri. Per altre informazioni sul pacchetto di rollup di Gestione filtri per Windows XP SP2, vedere l'articolo 914882 " Pacchetto di rollup di Gestione filtri per Windows XP SP2" nella Microsoft Knowledge Base.
Intestazione	fltuserstructures.h (include FltUser.h, FltKernel.h)