Fungsi FltGetFilterFromName (fltkernel.h)

Artikel
03/01/2024

Rutinitas FltGetFilterFromName mengembalikan penunjuk filter buram untuk driver minifilter terdaftar yang namanya cocok dengan nilai dalam parameter FilterName .

Sintaks

NTSTATUS FLTAPI FltGetFilterFromName(
  [in]  PCUNICODE_STRING FilterName,
  [out] PFLT_FILTER      *RetFilter
);

Parameter

[in] FilterName

Arahkan ke struktur UNICODE_STRING yang berisi nama driver minifilter. (Perbandingan nama tidak peka huruf besar/kecil.)

[out] RetFilter

Penunjuk ke variabel yang dialokasikan pemanggil yang menerima penunjuk filter buram untuk driver minifilter yang namanya cocok dengan nama dalam parameter FilterName . Parameter ini diperlukan dan tidak boleh NULL.

Nilai kembali

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

Menampilkan kode	Deskripsi
STATUS_FLT_DELETING_OBJECT	Driver minifilter yang cocok ditemukan, tetapi sedang dirobohkan. Ini adalah kode kesalahan.
STATUS_FLT_FILTER_NOT_FOUND	Tidak ditemukan pengandar minifilter yang cocok. Ini adalah kode kesalahan.

Keterangan

FltGetFilterFromName menambahkan referensi rundown ke penunjuk filter buram yang dikembalikan dalam parameter RetFilter . Ketika pointer ini tidak lagi diperlukan, pemanggil harus melepaskannya dengan memanggil FltObjectDereference. Dengan demikian setiap panggilan yang berhasil ke FltGetFilterFromName harus dicocokkan dengan panggilan berikutnya ke FltObjectDereference.

Untuk mendaftarkan driver minifilter dengan Filter Manager, panggil FltRegisterFilter.