struktur FILTER_AGGREGATE_STANDARD_INFORMATION (fltuserstructures.h)

Artikel
08/07/2023

Struktur FILTER_AGGREGATE_STANDARD_INFORMATION berisi informasi tentang minifilter atau driver filter warisan.

Sintaks

typedef struct _FILTER_AGGREGATE_STANDARD_INFORMATION {
  ULONG NextEntryOffset;
  ULONG Flags;
  union {
    struct {
      ULONG  Flags;
      ULONG  FrameID;
      ULONG  NumberOfInstances;
      USHORT FilterNameLength;
      USHORT FilterNameBufferOffset;
      USHORT FilterAltitudeLength;
      USHORT FilterAltitudeBufferOffset;
    } MiniFilter;
    struct {
      ULONG  Flags;
      USHORT FilterNameLength;
      USHORT FilterNameBufferOffset;
      USHORT FilterAltitudeLength;
      USHORT FilterAltitudeBufferOffset;
    } LegacyFilter;
  } Type;
} FILTER_AGGREGATE_STANDARD_INFORMATION, *PFILTER_AGGREGATE_STANDARD_INFORMATION;

Anggota

NextEntryOffset

Offset byte dari entri FILTER_AGGREGATE_STANDARD_INFORMATION berikutnya, jika beberapa entri ada dalam buffer. Anggota ini nol jika tidak ada entri lain yang mengikuti yang satu ini.

Flags

Menunjukkan apakah driver filter adalah filter warisan atau minifilter. Anggota ini harus menjadi salah satu nilai berikut.

Bendera	Makna
FLTFL_ASI_IS_MINIFILTER	Filter adalah minifilter - gunakan bagian MiniFilter dari serikat.
FLTFL_ASI_IS_LEGACYFILTER	Filter adalah filter warisan - gunakan bagian LegacyFilter dari serikat.

Type

Type.MiniFilter

Variabel struktur berlapis dengan anggota berikut:

Type.MiniFilter.Flags

Saat ini tidak ada bendera yang ditentukan untuk anggota ini.

Type.MiniFilter.FrameID

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

Type.MiniFilter.NumberOfInstances

Jumlah instans yang saat ini ada untuk minifilter.

Type.MiniFilter.FilterNameLength

Panjang, dalam byte, dari string nama minifilter.

Type.MiniFilter.FilterNameBufferOffset

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

Type.MiniFilter.FilterAltitudeLength

Panjang, dalam byte, dari string ketinggian minifilter.

Type.MiniFilter.FilterAltitudeBufferOffset

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

Type.LegacyFilter

Variabel struktur berlapis dengan anggota berikut:

Type.LegacyFilter.Flags

Saat ini tidak ada bendera yang ditentukan untuk anggota ini.

Type.LegacyFilter.FilterNameLength

Panjang, dalam byte, dari string nama filter warisan.

Type.LegacyFilter.FilterNameBufferOffset

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

Type.LegacyFilter.FilterAltitudeLength

Panjang, dalam byte, dari string ketinggian filter warisan.

Type.LegacyFilter.FilterAltitudeBufferOffset

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

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

Keterangan

Struktur FILTER_AGGREGATE_STANDARD_INFORMATION dapat dialokasikan dari kumpulan halaman atau tidak bertumpuk. Struktur ini diteruskan sebagai parameter ke rutinitas seperti:

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