struktur INSTANCE_AGGREGATE_STANDARD_INFORMATION (fltuserstructures.h)

Artikel
08/07/2023

Struktur INSTANCE_AGGREGATE_STANDARD_INFORMATION yang dialokasikan pemanggil berisi informasi standar agregat tentang instans driver minifilter atau driver filter warisan.

Sintaks

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;

Anggota

NextEntryOffset

Offset byte dari struktur INSTANCE_AGGREGATE_STANDARD_INFORMATION berikutnya jika beberapa struktur ada dalam buffer. Anggota ini nol jika tidak ada struktur lain yang mengikuti yang satu ini.

Flags

Menunjukkan apakah driver filter adalah driver filter warisan atau driver minifilter. Anggota ini harus berisi salah satu bendera berikut.

Bendera	Makna
FLTFL_IASI_IS_MINIFILTER	Driver filter adalah driver minifilter; gunakan bagian MiniFilter dari serikat.
FLTFL_IASI_IS_LEGACYFILTER	Driver filter adalah driver filter warisan; gunakan bagian LegacyFilter dari serikat.

Type

Variabel struktur berlapis dengan anggota berikut.

Type.MiniFilter

Type.MiniFilter.Flags

Bitmask bendera yang menjelaskan atribut instans minifilter. Berikut ini adalah nilai bendera yang valid.

Bendera	Makna
FLTFL_IASIM_DETACHED_VOLUME	Volume saat ini tidak dilampirkan ke tumpukan penyimpanan.

Type.MiniFilter.FrameID

Indeks berbasis nol yang digunakan untuk mengidentifikasi bingkai manajer filter tempat instans minifilter berada.

Type.MiniFilter.VolumeFileSystemType

Mengidentifikasi jenis sistem file yang dilampirkan instans minifilter. Nilai yang mungkin untuk anggota ini tercantum dalam FLT_FILESYSTEM_TYPE.

Type.MiniFilter.InstanceNameLength

Panjang, dalam byte, dari nama instans minifilter.

Type.MiniFilter.InstanceNameBufferOffset

Offset byte (relatif terhadap awal struktur) dari karakter pertama string nama instans minifilter Unicode. String ini tidak dihentikan NULL.

Type.MiniFilter.AltitudeLength

Panjang, dalam byte, dari string ketinggian instans minifilter.

Type.MiniFilter.AltitudeBufferOffset

Offset byte (relatif terhadap awal struktur) dari karakter pertama string ketinggian instans minifilter Unicode. String ini tidak dihentikan NULL.

Type.MiniFilter.VolumeNameLength

Panjang, dalam byte, dari nama volume volume tempat instans minifilter dilampirkan.

Type.MiniFilter.VolumeNameBufferOffset

Offset byte (relatif terhadap awal struktur) dari karakter pertama string nama volume Unicode untuk volume tempat instans minifilter dilampirkan. String ini tidak dihentikan NULL.

Type.MiniFilter.FilterNameLength

Panjang, dalam byte, dari nama minifilter minifilter tempat instans minifilter diturunkan.

Type.MiniFilter.FilterNameBufferOffset

Offset byte (relatif terhadap awal struktur) dari karakter pertama string nama minifilter Unicode untuk minifilter tempat instans minifilter diturunkan. String ini tidak dihentikan NULL.

Type.MiniFilter.SupportedFeatures

Bendera fitur yang didukung untuk filter, seperti yang ditentukan oleh nilai Registri SupportedFeatures minifilter. Fitur yang didukung adalah kombinasi bitwise OR dari bendera berikut.

Nilai	Makna
SUPPORTED_FS_FEATURES_OFFLOAD_READ (0x01)	Volume mendukung operasi baca yang dibongkar.
SUPPORTED_FS_FEATURES_OFFLOAD_WRITE (0x02)	Volume mendukung operasi tulis yang dibongkar.
SUPPORTED_FS_FEATURES_QUERY_OPEN (0x04)	Volume mendukung operasi buka kueri.
SUPPORTED_FS_FEATURES_BYPASS_IO (0x08)	Volume mendukung BypassIO. Bendera ini tersedia mulai dari Windows 11.

Type.LegacyFilter

Variabel struktur berlapis dengan anggota berikut.

Type.LegacyFilter.Flags

Bitmask bendera yang menjelaskan atribut filter warisan. Berikut ini adalah nilai bendera yang valid.

Bendera	Makna
FLTFL_IASIL_DETACHED_VOLUME	Volume saat ini tidak dilampirkan ke tumpukan penyimpanan.

Type.LegacyFilter.AltitudeLength

Panjang, dalam byte, dari string ketinggian filter warisan.

Type.LegacyFilter.AltitudeBufferOffset

Offset byte (relatif terhadap awal struktur) dari karakter pertama string ketinggian filter warisan Unicode. String ini tidak dihentikan NULL.

Dimulai dengan Windows Vista, ketinggian ditetapkan ke driver filter lama berdasarkan grup urutan beban driver. Ini memastikan bahwa driver minifilter akan berlapis dengan benar di atas dan di bawah driver filter warisan bahkan jika satu atau beberapa driver filter dimuat secara tidak berurutan.

Type.LegacyFilter.VolumeNameLength

Panjang, dalam byte, dari nama volume volume tempat filter warisan dilampirkan.

Type.LegacyFilter.VolumeNameBufferOffset

Offset byte (relatif terhadap awal struktur) dari karakter pertama string nama volume Unicode untuk volume tempat filter warisan dilampirkan. String ini tidak dihentikan NULL.

Type.LegacyFilter.FilterNameLength

Panjang, dalam byte, dari nama filter warisan.

Type.LegacyFilter.FilterNameBufferOffset

Offset byte (relatif terhadap awal struktur) dari karakter pertama string nama filter warisan Unicode. String ini tidak dihentikan NULL.

Type.LegacyFilter.SupportedFeatures

Bendera fitur yang didukung untuk filter warisan.

Fitur yang didukung adalah kombinasi bitwise OR dari bendera berikut.

Nilai	Makna
SUPPORTED_FS_FEATURES_OFFLOAD_READ (0x01)	Volume mendukung operasi baca yang dibongkar.
SUPPORTED_FS_FEATURES_OFFLOAD_WRITE (0x02)	Volume mendukung operasi tulis yang dibongkar.

Keterangan

Struktur jenis INSTANCE_AGGREGATE_STANDARD_INFORMATION dapat dialokasikan dari kumpulan halaman atau tidak berpakaian. Struktur ini diteruskan sebagai parameter ke rutinitas seperti berikut:

Struktur INSTANCE_AGGREGATE_STANDARD_INFORMATION harus diselaraskan pada batas LONGLONG (8-byte). Jika buffer berisi dua atau lebih struktur ini, nilai NextEntryOffset di setiap entri jatuh pada batas 8-byte.