struttura FILTER_AGGREGATE_STANDARD_INFORMATION (fltuserstructures.h)

Articolo
08/07/2023

La struttura FILTER_AGGREGATE_STANDARD_INFORMATION contiene informazioni su un minifilter o un driver di filtro legacy.

Sintassi

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;

Members

NextEntryOffset

Offset di byte della voce di FILTER_AGGREGATE_STANDARD_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_ASI_IS_MINIFILTER	Il filtro è un minifiltro: usare la parte MiniFilter dell'unione.
FLTFL_ASI_IS_LEGACYFILTER	Il filtro è un filtro legacy: usare la parte LegacyFilter dell'unione.

Type

Type.MiniFilter

Variabile struttura annidata con i membri seguenti:

Type.MiniFilter.Flags

Attualmente non sono stati definiti flag per questo membro.

Type.MiniFilter.FrameID

Indice in base zero usato per identificare il frame di gestione filtri in cui si trova il minifilter.

Type.MiniFilter.NumberOfInstances

Numero di istanze attualmente esistenti per il minifilter.

Type.MiniFilter.FilterNameLength

Lunghezza, in byte, della stringa del nome del minifilter.

Type.MiniFilter.FilterNameBufferOffset

Offset di byte (relativo all'inizio della struttura) del primo carattere della stringa del nome del minifilter Unicode. La stringa non è con terminazione NULL.

Type.MiniFilter.FilterAltitudeLength

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

Type.MiniFilter.FilterAltitudeBufferOffset

Offset di byte (rispetto all'inizio della struttura) del primo carattere della stringa di altitudine del minifiltro Unicode. La stringa non è con terminazione NULL.

Type.LegacyFilter

Variabile struttura annidata con i membri seguenti:

Type.LegacyFilter.Flags

Attualmente non sono stati definiti flag per questo membro.

Type.LegacyFilter.FilterNameLength

Lunghezza, in byte, della stringa del nome del filtro legacy.

Type.LegacyFilter.FilterNameBufferOffset

Offset di byte (rispetto all'inizio della struttura) del primo carattere della stringa del nome del filtro legacy Unicode. La stringa non è con terminazione NULL.

Type.LegacyFilter.FilterAltitudeLength

Lunghezza, in byte, della stringa di altitudine del filtro legacy.

Type.LegacyFilter.FilterAltitudeBufferOffset

Offset di byte (rispetto all'inizio della struttura) del primo carattere della stringa di altitudine del filtro legacy Unicode. La stringa non è con terminazione NULL.

A partire da Windows Vista, le altitudini vengono assegnate ai driver di filtro legacy in base al gruppo di ordini di carico del driver. In questo modo si garantisce che i driver del filtro minifiltro vengano sovrapposti correttamente sopra e sotto i driver di filtro legacy anche se uno o più driver di filtro vengono caricati in ordine non ordinato.

Commenti

La struttura FILTER_AGGREGATE_STANDARD_INFORMATION può essere allocata da un pool di paging o non di paging. Questa struttura viene passata come parametro alle routine, ad esempio:

La struttura FILTER_AGGREGATE_STANDARD_INFORMATION deve essere allineata su un limite LONGLONG (8 byte). Se un buffer contiene due o più di queste strutture, il valore NextEntryOffset in ogni voce rientra in un limite di 8 byte.

Requisiti

Requisito	Valore
Client minimo supportato	Questa struttura è disponibile a partire da Windows Vista.
Intestazione	fltuserstructures.h (include FltUser.h, FltKernel.h)