INSTANCE_AGGREGATE_STANDARD_INFORMATION-Struktur (fltuserstructures.h)

Artikel
08/07/2023

Die vom Aufrufer zugewiesene INSTANCE_AGGREGATE_STANDARD_INFORMATION-Struktur enthält aggregierte Standardinformationen zu einem Minifiltertreiber instance oder 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;

Member

NextEntryOffset

Byteoffset der nächsten INSTANCE_AGGREGATE_STANDARD_INFORMATION Struktur, wenn mehrere Strukturen in einem Puffer vorhanden sind. Dieses Element ist 0, wenn keine anderen Strukturen dieser Struktur folgen.

Flags

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

Flag	Bedeutung
FLTFL_IASI_IS_MINIFILTER	Der Filtertreiber ist ein Minifiltertreiber. Verwenden Sie den MiniFilter-Teil der Union.
FLTFL_IASI_IS_LEGACYFILTER	Der Filtertreiber ist ein Legacyfiltertreiber. verwenden Sie den LegacyFilter-Teil der Union.

Type

Geschachtelte Strukturvariable mit den folgenden Membern.

Type.MiniFilter

Type.MiniFilter.Flags

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

Flag	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 der Minifilter instance befindet.

Type.MiniFilter.VolumeFileSystemType

Gibt den Typ des Dateisystems an, dem der Minifilter instance angefügt ist. Die möglichen Werte für diesen Member sind in FLT_FILESYSTEM_TYPE aufgeführt.

Type.MiniFilter.InstanceNameLength

Länge des Minifilters in Bytes instance Namen.

Type.MiniFilter.InstanceNameBufferOffset

Byteoffset (relativ zum Anfang der Struktur) des ersten Zeichens des Unicode-Minifilters instance Namenszeichenfolge. Diese Zeichenfolge ist nicht NULL-beendet.

Type.MiniFilter.AltitudeLength

Länge des Minifilters in Bytes instance Höhenzeichenfolge.

Type.MiniFilter.AltitudeBufferOffset

Byteoffset (relativ zum Anfang der Struktur) des ersten Zeichens des Unicode-Minifilters instance Höhenzeichenfolge. Diese Zeichenfolge ist nicht NULL-beendet.

Type.MiniFilter.VolumeNameLength

Länge (in Bytes) des Volumenamens des Volumes, an das der Minifilter instance ist.

Type.MiniFilter.VolumeNameBufferOffset

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

Type.MiniFilter.FilterNameLength

Länge (in Bytes) des Minifilternamens des Minifilters, von dem der Minifilter instance abgeleitet wurde.

Type.MiniFilter.FilterNameBufferOffset

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

Type.MiniFilter.SupportedFeatures

Die unterstützten Featureflags für den Filter, wie durch den Wert supportedFeatures Registry 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 entladene Lesevorgänge.
SUPPORTED_FS_FEATURES_OFFLOAD_WRITE (0x02)	Das Volume unterstützt abgeladene Schreibvorgänge.
SUPPORTED_FS_FEATURES_QUERY_OPEN (0x04)	Das Volume unterstützt offene Abfragevorgänge.
SUPPORTED_FS_FEATURES_BYPASS_IO (0x08)	Das Volume unterstützt BypassIO. Dieses Flag ist ab Windows 11 verfügbar.

Type.LegacyFilter

Geschachtelte Strukturvariable mit den folgenden Membern.

Type.LegacyFilter.Flags

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

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

Type.LegacyFilter.AltitudeLength

Länge (in Bytes) der Legacyfilterhöhenzeichenfolge.

Type.LegacyFilter.AltitudeBufferOffset

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

Ab Windows Vista werden Höhen basierend auf der Ladereihenfolgegruppe des Treibers Legacyfiltertreibern zugewiesen. Dadurch wird sichergestellt, dass Minifiltertreiber ordnungsgemäß über und unter legacy-Filtertreibern liegen, auch wenn mindestens einer der Filtertreiber aus der Reihenfolge geladen wird.

Type.LegacyFilter.VolumeNameLength

Länge (in Bytes) des Volumenamens des Volumes, an das der Legacyfilter angefügt ist.

Type.LegacyFilter.VolumeNameBufferOffset

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

Type.LegacyFilter.FilterNameLength

Länge des Legacyfilternamens in Bytes.

Type.LegacyFilter.FilterNameBufferOffset

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

Type.LegacyFilter.SupportedFeatures

Die unterstützten Featureflags 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 entladene Lesevorgänge.
SUPPORTED_FS_FEATURES_OFFLOAD_WRITE (0x02)	Das Volume unterstützt abgeladene Schreibvorgänge.

Hinweise

Eine Struktur vom Typ INSTANCE_AGGREGATE_STANDARD_INFORMATION kann aus einem ausgelagerten oder nicht ausgelagerten Pool zugeordnet 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 mindestens zwei dieser Strukturen enthält, fällt der NextEntryOffset-Wert in jedem Eintrag auf eine 8-Byte-Grenze.