Fungsi FltUnloadFilter (fltkernel.h)

Driver minifilter yang telah memuat driver minifilter pendukung dengan memanggil FltLoadFilter dapat membongkar driver minifilter dengan memanggil FltUnloadFilter.

Sintaks

NTSTATUS FLTAPI FltUnloadFilter(
  [in] PCUNICODE_STRING FilterName
);

Parameter

[in] FilterName

Pointer ke struktur UNICODE_STRING yang berisi nama layanan driver minifilter yang diteruskan ke FltLoadFilter.

Nilai kembali

FltUnloadFilter 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 sudah dirobohkan. Ini adalah kode kesalahan.
STATUS_FLT_FILTER_NOT_FOUND	Tidak ditemukan pengandar minifilter yang cocok. Ini adalah kode kesalahan.

Keterangan

Driver minifilter yang memiliki dependensi pada driver minifilter lain dapat membongkar driver minifilter tersebut dengan memanggil FltUnloadFilter. Rutin mencari driver minifilter terdaftar yang nama layanannya cocok dengan FilterName yang diberikan dan memanggil rutinitas FilterUnloadCallback (PFLT_FILTER_UNLOAD_CALLBACK) driver minifilter.

Jika driver minifilter pendukung tidak mendaftarkan rutinitas FilterUnloadCallback , panggilan ke FltUnloadFilter gagal.

Driver minifilter tidak dapat memanggil FltUnloadFilter untuk membongkar sendiri.

Persyaratan

Persyaratan	Nilai
Target Platform	Universal
Header	fltkernel.h (termasuk Fltkernel.h)
Pustaka	FltMgr.lib
DLL	Fltmgr.sys
IRQL	PASSIVE_LEVEL

Lihat juga

FltLoadFilter

PFLT_FILTER_UNLOAD_CALLBACK

UNICODE_STRING