Fungsi FilterInstanceCreate (fltuser.h)
Fungsi FilterInstanceCreate membuat handel yang dapat digunakan untuk berkomunikasi dengan instans minifilter yang diberikan.
Sintaks
HRESULT FilterInstanceCreate(
[in] LPCWSTR lpFilterName,
[in] LPCWSTR lpVolumeName,
[in, optional] LPCWSTR lpInstanceName,
[out] HFILTER_INSTANCE *hInstance
);
Parameter
[in] lpFilterName
Penunjuk ke string karakter lebar yang dihentikan null yang berisi nama minifilter yang memiliki instans.
[in] lpVolumeName
Penunjuk ke string karakter lebar yang dihentikan null yang berisi nama volume tempat instans dilampirkan.
String input lpVolumeName dapat berupa salah satu dari berikut ini. Garis miring terbelakang berikutnya (\) bersifat opsional.
- Huruf kandar, seperti "D:\"
- Jalur ke titik pemasangan volume, seperti "c:\mnt\edrive\"
- Pengidentifikasi volume unik (juga disebut nama GUID volume), seperti "\?? \Volume{7603f260-142a-11d4-ac67-806d6172696f}\"
- Nama perangkat yang tidak konsisten (juga disebut nama target atau nama perangkat NT), seperti "\Device\HarddiskVolume1\"
[in, optional] lpInstanceName
Penunjuk ke string karakter lebar yang dihentikan null yang berisi nama instans untuk instans. Parameter ini bersifat opsional dan dapat berupa NULL. Jika NULL, instans pertama yang ditemukan untuk minifilter ini pada volume ini dikembalikan.
[out] hInstance
Penunjuk ke variabel yang dialokasikan penelepon yang menerima handel buram untuk instans minifilter jika panggilan ke FilterInstanceCreate berhasil; jika tidak, ia menerima INVALID_HANDLE_VALUE.
Nilai kembali
FilterInstanceCreate mengembalikan S_OK jika berhasil. Jika tidak, ia mengembalikan nilai kesalahan.
Keterangan
Aplikasi mode pengguna memanggil FilterInstanceCreate untuk membuat handel yang dapat digunakan untuk berkomunikasi dengan instans minifilter mode kernel. Handel instans yang dikembalikan dapat diteruskan sebagai parameter ke fungsi seperti FilterInstanceGetInformation.
Untuk menutup handel instans yang dikembalikan oleh FilterInstanceCreate, panggil FilterInstanceClose.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Universal |
| Header | fltuser.h (termasuk Fltuser.h) |
| Pustaka | FltLib.lib |
| DLL | FltLib.dll |