Fungsi FltGetFilterInformation (fltkernel.h)

Artikel
08/07/2023

Rutinitas FltGetFilterInformation menyediakan informasi tentang driver minifilter.

Sintaks

NTSTATUS FLTAPI FltGetFilterInformation(
  [in]  PFLT_FILTER              Filter,
  [in]  FILTER_INFORMATION_CLASS InformationClass,
  [out] PVOID                    Buffer,
  [in]  ULONG                    BufferSize,
  [out] PULONG                   BytesReturned
);

Parameter

[in] Filter

Penunjuk filter buram untuk pemanggil.

[in] InformationClass

Jenis informasi yang diminta. Parameter ini dapat memiliki salah satu nilai berikut.

Nilai	Makna
FilterFullInformation	Buffer yang ditujukkan oleh parameter Buffer menerima struktur FILTER_FULL_INFORMATION untuk driver minifilter.
FilterAggregateBasicInformation	Buffer yang ditujukkan oleh parameter Buffer menerima struktur FILTER_AGGREGATE_BASIC_INFORMATION untuk driver minifilter. Nilai InformationClass ini tersedia dimulai dengan Microsoft Windows Server 2003 SP1 dan Windows XP SP2 dengan rollup manajer filter. Untuk informasi selengkapnya tentang paket rollup manajer filter untuk Windows XP SP2, lihat artikel 914882, " Paket rollup manajer filter untuk Windows XP SP2," di Pangkalan Pengetahuan Microsoft.
FilterAggregateStandardInformation	Buffer yang ditujukkan oleh parameter Buffer menerima struktur FILTER_AGGREGATE_STANDARD_INFORMATION untuk driver minifilter. Bagian LegacyFilter dari struktur tidak digunakan. Nilai InformationClass ini tersedia dimulai dengan Windows Vista.

[out] Buffer

Arahkan ke buffer yang dialokasikan penelepon yang menerima informasi yang diminta. Jenis informasi yang dikembalikan dalam buffer ditentukan oleh parameter InformationClass .

[in] BufferSize

Ukuran, dalam byte, dari buffer yang dirujuk parameter Buffer . Pemanggil harus mengatur parameter ini sesuai dengan nilai InformationClass yang diberikan.

[out] BytesReturned

Penunjuk ke variabel yang dialokasikan pemanggil yang menerima jumlah byte yang dikembalikan dalam buffer yang dituju Buffer . Jika nilai input BufferSize terlalu kecil, FltGetFilterInformation mengembalikan STATUS_BUFFER_TOO_SMALL dan mengatur variabel ini ke jumlah byte yang diperlukan untuk menyimpan informasi yang diminta. Parameter ini diperlukan dan tidak boleh NULL.

Nilai kembali

FltGetFilterInformation mengembalikan STATUS_SUCCESS atau nilai NTSTATUS yang sesuai, seperti salah satu hal berikut ini:

Menampilkan kode	Deskripsi
STATUS_BUFFER_TOO_SMALL	Buffer yang dirujuk parameter Buffer tidak cukup besar untuk menyimpan informasi yang diminta. Ini adalah kode kesalahan.
STATUS_INVALID_PARAMETER	Nilai yang tidak valid ditentukan untuk parameter InformationClass . Misalnya, jika FilterAggregateStandardInformation ditentukan pada sistem operasi sebelum Windows Vista, rutinitas mengembalikan STATUS_INVALID_PARAMETER. Ini adalah kode kesalahan.