INSTANCE_AGGREGATE_STANDARD_INFORMATION struttura (fltuserstructures.h)

Articolo
02/26/2024

La struttura INSTANCE_AGGREGATE_STANDARD_INFORMATION allocata dal chiamante contiene informazioni standard aggregate su un'istanza del driver minifilter 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;

Members

NextEntryOffset

Offset di byte della struttura di 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 minifilter. Questo membro deve contenere uno dei flag seguenti.

Contrassegno	Significato
FLTFL_IASI_IS_MINIFILTER	Il driver di filtro è un driver minifilter; usare la parte MiniFilter dell'unione.
FLTFL_IASI_IS_LEGACYFILTER	Il driver di filtro è un driver di filtro legacy; usare la parte LegacyFilter dell'unione.

Type

Variabile struttura annidata con i membri seguenti.

Type.MiniFilter

Type.MiniFilter.Flags

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

Contrassegno	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 minifilter.

Type.MiniFilter.VolumeFileSystemType

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

Type.MiniFilter.InstanceNameLength

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

Type.MiniFilter.InstanceNameBufferOffset

Offset byte (relativo all'inizio della struttura) del primo carattere della stringa nome dell'istanza di minifilter Unicode. Questa stringa non viene terminata con null.

Type.MiniFilter.AltitudeLength

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

Type.MiniFilter.AltitudeBufferOffset

Offset di byte (relativo all'inizio della struttura) del primo carattere della stringa di altitudine dell'istanza di minifilter Unicode. Questa stringa non viene terminata con null.

Type.MiniFilter.VolumeNameLength

Lunghezza, in byte, del nome del volume a cui è associata l'istanza del minifilter.

Type.MiniFilter.VolumeNameBufferOffset

Offset di byte (relativo all'inizio della struttura) del primo carattere della stringa del nome del volume Unicode per il volume a cui è associata l'istanza del minifilter. Questa stringa non viene terminata con null.

Type.MiniFilter.FilterNameLength

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

Type.MiniFilter.FilterNameBufferOffset

Offset byte (relativo all'inizio della struttura) del primo carattere della stringa del nome minifilter Unicode per il minifilter da cui è derivata l'istanza del minifilter. Questa stringa non viene terminata con null.

Type.MiniFilter.SupportedFeatures

Flag di funzionalità supportati per il filtro, come specificato dal valore SupportFeatures Del Registro di sistema supportato da un minifilter. 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 disattivate.
SUPPORTED_FS_FEATURES_OFFLOAD_WRITE (0x02 )	Il volume supporta operazioni di scrittura caricate.
SUPPORTED_FS_FEATURES_QUERY_OPEN (0x04 )	Il volume supporta operazioni di apertura 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 flag che descrivono gli attributi del filtro legacy. Di seguito sono riportati valori di flag validi.

Contrassegno	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 viene terminata con 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 minifilter verranno caricati correttamente sopra e sotto i driver di filtro legacy, anche se uno o più dei 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 byte (relativo 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 viene terminata con null.

Type.LegacyFilter.FilterNameLength

Lunghezza, in byte, del nome del filtro legacy.

Type.LegacyFilter.FilterNameBufferOffset

Offset byte (relativo all'inizio della struttura) del primo carattere della stringa del nome del filtro legacy Unicode. Questa stringa non viene terminata con 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 disattivate.
SUPPORTED_FS_FEATURES_OFFLOAD_WRITE (0x02)	Il volume supporta operazioni di scrittura caricate.

Commenti

Una struttura di tipo INSTANCE_AGGREGATE_STANDARD_INFORMATION può essere allocata da un pool di pagine o non a pagine. Questa struttura viene passata come parametro alle routine, ad esempio quanto segue:

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