Fungsi FilterLoad (fltuser.h)

Artikel
08/23/2023

Fungsi FilterLoad secara dinamis memuat driver minifilter ke dalam sistem.

Sintaks

HRESULT FilterLoad(
  [in] LPCWSTR lpFilterName
);

Parameter

[in] lpFilterName

Penunjuk ke string karakter lebar yang dihentikan null yang menentukan nama layanan driver minifilter. Parameter ini diperlukan dan tidak boleh NULL atau string kosong.

Menampilkan nilai

FilterLoad mengembalikan S_OK jika berhasil. Jika tidak, ia mengembalikan salah satu nilai kesalahan berikut:

Menampilkan kode	Deskripsi
HRESULT_FROM_WIN32 (ERROR_ALREADY_EXISTS)	Driver minifilter sudah berjalan.
HRESULT_FROM_WIN32 (ERROR_FILE_NOT_FOUND)	Tidak ditemukan pengandar minifilter yang cocok.
HRESULT_FROM_WIN32 (ERROR_SERVICE_ALREADY_RUNNING)	Driver minifilter sudah berjalan.
HRESULT_FROM_WIN32 (ERROR_BAD_EXE_FORMAT)	Gambar beban untuk driver minifilter yang ditentukan oleh lpFilterName tidak valid.
HRESULT_FROM_WIN32 (ERROR_BAD_DRIVER)	Gambar beban untuk driver minifilter yang ditentukan oleh lpFilterName tidak valid.
HRESULT_FROM_WIN32 (ERROR_INVALID_IMAGE_HASH)	Driver minifilter memiliki tanda tangan digital yang tidak valid.

Keterangan

FilterLoad setara dengan Win32 dari FltLoadFilter.

Aplikasi mode pengguna yang memiliki dependensi pada driver minifilter mode kernel dapat memuat driver minifilter dengan memanggil FilterLoad.

Pemanggil FilterLoad harus memiliki SeLoadDriverPrivilege (LUID SE_LOAD_DRIVER_PRIVILEGE) untuk memuat atau membongkar driver minifilter. Hak istimewa ini dinamai oleh konstanta nama SE_LOAD_DRIVER_NAME. (Hak istimewa dijelaskan dalam Microsoft Windows Software Development Kit (SDK) untuk dokumentasi Windows 7 dan .NET Framework 4.0.)

Untuk membongkar driver minifilter, panggil FilterUnload.