struttura INSTANCE_AGGREGATE_STANDARD_INFORMATION (fltuserstructures.h)

Articolo
02/06/2025

La struttura INSTANCE_AGGREGATE_STANDARD_INFORMATION allocata dal chiamante contiene informazioni standard aggregate su un'istanza del driver minifiltro o su un driver di filtro legacy.

Sintassi

typedef struct _INSTANCE_AGGREGATE_STANDARD_INFORMATION {
  ULONG NextEntryOffset;
  ULONG Flags;
  union {
    struct {
      ULONG               Flags;
      ULONG               FrameID;
      FLT_FILESYSTEM_TYPE VolumeFileSystemType;
      USHORT              InstanceNameLength;
      USHORT              InstanceNameBufferOffset;
      USHORT              AltitudeLength;
      USHORT              AltitudeBufferOffset;
      USHORT              VolumeNameLength;
      USHORT              VolumeNameBufferOffset;
      USHORT              FilterNameLength;
      USHORT              FilterNameBufferOffset;
      ULONG               SupportedFeatures;
    } MiniFilter;
    struct {
      ULONG  Flags;
      USHORT AltitudeLength;
      USHORT AltitudeBufferOffset;
      USHORT VolumeNameLength;
      USHORT VolumeNameBufferOffset;
      USHORT FilterNameLength;
      USHORT FilterNameBufferOffset;
      ULONG  SupportedFeatures;
    } LegacyFilter;
  } Type;
} INSTANCE_AGGREGATE_STANDARD_INFORMATION, *PINSTANCE_AGGREGATE_STANDARD_INFORMATION;

Membri

NextEntryOffset

Offset di byte della struttura INSTANCE_AGGREGATE_STANDARD_INFORMATION successiva se in un buffer sono presenti più strutture. Questo membro è zero se nessun'altra struttura segue questa.

Flags

Indica se il driver di filtro è un driver di filtro legacy o un driver minifiltro. Questo membro deve contenere uno dei flag seguenti.

Bandiera	Significato
FLTFL_IASI_IS_MINIFILTER	Il driver di filtro è un driver minifiltro; utilizzare la parte MiniFilter dell'unione.
FLTFL_IASI_IS_LEGACYFILTER	Il driver di filtro è un driver di filtro legacy; utilizzare la parte legacyFilter dell'unione.

Type

Variabile struttura annidata con i membri seguenti.

Type.MiniFilter

Type.MiniFilter.Flags

Maschera di bit di flag che descrivono gli attributi dell'istanza del minifiltro. Di seguito sono riportati valori di flag validi.

Bandiera	Significato
FLTFL_IASIM_DETACHED_VOLUME	Il volume non è attualmente collegato a uno stack di archiviazione.

Type.MiniFilter.FrameID

Indice in base zero usato per identificare il frame di gestione filtri in cui si trova l'istanza del minifiltro.

Type.MiniFilter.VolumeFileSystemType

Identifica il tipo di file system a cui è collegata l'istanza del minifiltro. I valori possibili per questo membro sono elencati in FLT_FILESYSTEM_TYPE.

Type.MiniFilter.InstanceNameLength

Lunghezza, in byte, del nome dell'istanza del minifiltro.

Type.MiniFilter.InstanceNameBufferOffset

Offset di byte (rispetto all'inizio della struttura) del primo carattere della stringa del nome dell'istanza del minifiltro Unicode. Questa stringa non è con terminazione NULL.

Type.MiniFilter.AltitudeLength

Lunghezza, in byte, della stringa di altitudine dell'istanza del minifiltro.

Type.MiniFilter.AltitudeBufferOffset

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

Type.MiniFilter.VolumeNameLength

Lunghezza, in byte, del nome del volume a cui è collegata l'istanza del minifiltro.

Type.MiniFilter.VolumeNameBufferOffset

Offset di byte (rispetto all'inizio della struttura) del primo carattere della stringa del nome del volume Unicode per il volume a cui è collegata l'istanza del minifiltro. Questa stringa non è con terminazione NULL.

Type.MiniFilter.FilterNameLength

Lunghezza, in byte, del nome del minifiltro del minifiltro da cui è stata derivata l'istanza del minifiltro.

Type.MiniFilter.FilterNameBufferOffset

Offset di byte (rispetto all'inizio della struttura) del primo carattere della stringa del nome minifiltro Unicode per il minifiltro da cui è stata derivata l'istanza del minifiltro. Questa stringa non è con terminazione NULL.

Type.MiniFilter.SupportedFeatures

Flag di funzionalità supportati per il filtro, come specificato da SupportedFeatures di un minifiltro valore del Registro di sistema. Le funzionalità supportate sono una combinazione OR bit per bit dei flag seguenti.

Valore	Significato
SUPPORTED_FS_FEATURES_OFFLOAD_READ (0x01)	Il volume supporta operazioni di lettura scaricate.
SUPPORTED_FS_FEATURES_OFFLOAD_WRITE (0x02)	Il volume supporta operazioni di scrittura offloaded.
SUPPORTED_FS_FEATURES_QUERY_OPEN (0x04)	Il volume supporta le operazioni di apertura delle query.
SUPPORTED_FS_FEATURES_BYPASS_IO (0x08)	Il volume supporta BypassIO. Questo flag è disponibile a partire da Windows 11.

Type.LegacyFilter

Variabile struttura annidata con i membri seguenti.

Type.LegacyFilter.Flags

Maschera di bit di flag che descrivono gli attributi del filtro legacy. Di seguito sono riportati valori di flag validi.

Bandiera	Significato
FLTFL_IASIL_DETACHED_VOLUME	Il volume non è attualmente collegato a uno stack di archiviazione.

Type.LegacyFilter.AltitudeLength

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

Type.LegacyFilter.AltitudeBufferOffset

Offset di byte (rispetto all'inizio della struttura) del primo carattere della stringa di altitudine del filtro legacy Unicode. Questa 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, i driver minifiltri verranno sovrapposti correttamente sopra e sotto i driver di filtro legacy anche se uno o più driver di filtro vengono caricati fuori ordine.

Type.LegacyFilter.VolumeNameLength

Lunghezza, in byte, del nome del volume a cui è associato il filtro legacy.

Type.LegacyFilter.VolumeNameBufferOffset

Offset di byte (rispetto all'inizio della struttura) del primo carattere della stringa del nome del volume Unicode per il volume a cui è associato il filtro legacy. Questa stringa non è con terminazione NULL.

Type.LegacyFilter.FilterNameLength

Lunghezza, in byte, 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. Questa stringa non è con terminazione NULL.

Type.LegacyFilter.SupportedFeatures

Flag di funzionalità supportati per il filtro legacy.

Le funzionalità supportate sono una combinazione OR bit per bit dei flag seguenti.

Valore	Significato
SUPPORTED_FS_FEATURES_OFFLOAD_READ (0x01)	Il volume supporta operazioni di lettura scaricate.
SUPPORTED_FS_FEATURES_OFFLOAD_WRITE (0x02)	Il volume supporta operazioni di scrittura offloaded.

Osservazioni

Una struttura di tipo INSTANCE_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 le seguenti:

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