INSTANCE_AGGREGATE_STANDARD_INFORMATION Struktur (fltuserstructures.h)

Artikel
02/06/2025

Die vom Aufrufer zugewiesene INSTANCE_AGGREGATE_STANDARD_INFORMATION Struktur enthält aggregierte Standardinformationen zu einer Minifiltertreiberinstanz oder zu einem Legacyfiltertreiber.

Syntax

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;

Angehörige

NextEntryOffset

Byte-Offset der nächsten INSTANCE_AGGREGATE_STANDARD_INFORMATION Struktur, wenn mehrere Strukturen in einem Puffer vorhanden sind. Dieses Element ist null, wenn keine anderen Strukturen diesem Folgen folgen.

Flags

Gibt an, ob der Filtertreiber ein Legacyfiltertreiber oder ein Minifiltertreiber ist. Dieses Element muss eines der folgenden Flags enthalten.

Flagge	Bedeutung
FLTFL_IASI_IS_MINIFILTER	Der Filtertreiber ist ein Minifiltertreiber; verwenden Sie den MiniFilter Teil der Vereinigung.
FLTFL_IASI_IS_LEGACYFILTER	Der Filtertreiber ist ein Legacyfiltertreiber; verwenden Sie den LegacyFilter- Teil der Union.

Type

Geschachtelte Strukturvariable mit den folgenden Elementen.

Type.MiniFilter

Type.MiniFilter.Flags

Eine Bitmaske von Flags, die Attribute der Minifilterinstanz beschreiben. Im Folgenden sind gültige Flagwerte aufgeführt.

Flagge	Bedeutung
FLTFL_IASIM_DETACHED_VOLUME	Das Volume ist derzeit nicht an einen Speicherstapel angefügt.

Type.MiniFilter.FrameID

Nullbasierter Index, der verwendet wird, um den Filter-Manager-Frame zu identifizieren, in dem sich die Minifilterinstanz befindet.

Type.MiniFilter.VolumeFileSystemType

Gibt den Typ des Dateisystems an, an das die Minifilterinstanz angefügt ist. Die möglichen Werte für dieses Element werden in FLT_FILESYSTEM_TYPEaufgeführt.

Type.MiniFilter.InstanceNameLength

Länge des Minifilterinstanznamens in Bytes.

Type.MiniFilter.InstanceNameBufferOffset

Byte-Offset (relativ zum Anfang der Struktur) des ersten Zeichens der Unicode-Minifilterinstanznamenzeichenfolge. Diese Zeichenfolge ist nicht NULL beendet.

Type.MiniFilter.AltitudeLength

Länge der Höhe der Minifilterinstanzzeichenfolge in Byte.

Type.MiniFilter.AltitudeBufferOffset

Byte-Offset (relativ zum Anfang der Struktur) des ersten Zeichens der Unicode-Minifilterinstanzhöhenzeichenfolge. Diese Zeichenfolge ist nicht NULL beendet.

Type.MiniFilter.VolumeNameLength

Länge des Volumenamens des Volumes, an das die Minifilterinstanz angefügt ist.

Type.MiniFilter.VolumeNameBufferOffset

Byte-Offset (relativ zum Anfang der Struktur) des ersten Zeichens der Unicode-Volumenamenzeichenfolge für das Volume, an das die Minifilterinstanz angefügt ist. Diese Zeichenfolge ist nicht NULL beendet.

Type.MiniFilter.FilterNameLength

Länge des Minifilternamens des Minifilters, von dem die Minifilterinstanz abgeleitet wurde.

Type.MiniFilter.FilterNameBufferOffset

Byte-Offset (relativ zum Anfang der Struktur) des ersten Zeichens der Unicode-Minifilternamenzeichenfolge für den Minifilter, von dem die Minifilterinstanz abgeleitet wurde. Diese Zeichenfolge ist nicht NULL beendet.

Type.MiniFilter.SupportedFeatures

Die unterstützten Featurekennzeichnungen für den Filter, wie durch den SupportedFeatures Registrierungswert eines Minifilters angegeben. Die unterstützten Features sind eine bitweise OR-Kombination der folgenden Flags.

Wert	Bedeutung
SUPPORTED_FS_FEATURES_OFFLOAD_READ (0x01)	Das Volume unterstützt deaktivierte Lesevorgänge.
SUPPORTED_FS_FEATURES_OFFLOAD_WRITE (0x02)	Das Volume unterstützt entladene Schreibvorgänge.
SUPPORTED_FS_FEATURES_QUERY_OPEN (0x04)	Das Volume unterstützt Vorgänge zum Öffnen von Abfragen.
SUPPORTED_FS_FEATURES_BYPASS_IO (0x08)	Das Volume unterstützt BypassIO-. Dieses Kennzeichen ist ab Windows 11 verfügbar.

Type.LegacyFilter

Geschachtelte Strukturvariable mit den folgenden Elementen.

Type.LegacyFilter.Flags

Eine Bitmaske von Flags, die Attribute des Legacyfilters beschreiben. Im Folgenden sind gültige Flagwerte aufgeführt.

Flagge	Bedeutung
FLTFL_IASIL_DETACHED_VOLUME	Das Volume ist derzeit nicht an einen Speicherstapel angefügt.

Type.LegacyFilter.AltitudeLength

Länge in Byte der Zeichenfolge für legacyfilterhöhe.

Type.LegacyFilter.AltitudeBufferOffset

Byte-Offset (relativ zum Anfang der Struktur) des ersten Zeichens der Unicode-Legacyfilterhöhenzeichenfolge. Diese Zeichenfolge ist nicht NULL beendet.

Ab Windows Vista werden Höhen älteren Filtertreibern basierend auf der Ladereihenfolge des Treibers zugewiesen. Dadurch wird sichergestellt, dass Minifiltertreiber über und unter älteren Filtertreibern ordnungsgemäß über und unter älteren Filtertreibern angeordnet werden, auch wenn mindestens eine der Filtertreiber nicht ordnungsgemäß geladen wird.

Type.LegacyFilter.VolumeNameLength

Länge des Volumenamens des Volumes, dem der Legacyfilter zugeordnet ist, in Bytes.

Type.LegacyFilter.VolumeNameBufferOffset

Byte-Offset (relativ zum Anfang der Struktur) des ersten Zeichens der Unicode-Volumenamenzeichenfolge für das Volume, dem der Legacyfilter zugeordnet ist. Diese Zeichenfolge ist nicht NULL beendet.

Type.LegacyFilter.FilterNameLength

Länge des Legacyfilternamens in Byte.

Type.LegacyFilter.FilterNameBufferOffset

Byte-Offset (relativ zum Anfang der Struktur) des ersten Zeichens der Unicode-Legacyfilternamenzeichenfolge. Diese Zeichenfolge ist nicht NULL beendet.

Type.LegacyFilter.SupportedFeatures

Die unterstützten Featurekennzeichnungen für den Legacyfilter.

Die unterstützten Features sind eine bitweise OR-Kombination der folgenden Flags.

Wert	Bedeutung
SUPPORTED_FS_FEATURES_OFFLOAD_READ (0x01)	Das Volume unterstützt deaktivierte Lesevorgänge.
SUPPORTED_FS_FEATURES_OFFLOAD_WRITE (0x02)	Das Volume unterstützt entladene Schreibvorgänge.

Bemerkungen

Eine Struktur vom Typ INSTANCE_AGGREGATE_STANDARD_INFORMATION kann aus seitenseitigem oder nicht seitenseitigem Pool zugewiesen werden. Diese Struktur wird als Parameter an Routinen wie die folgenden übergeben:

Die INSTANCE_AGGREGATE_STANDARD_INFORMATION Struktur muss an einer LONGLONG-Grenze (8-Byte) ausgerichtet werden. Wenn ein Puffer zwei oder mehr dieser Strukturen enthält, fällt der NextEntryOffset Wert in jedem Eintrag auf eine Grenze von 8 Byte.