Fungsi FwpsCalloutRegister0 (fwpsk.h)
Fungsi FwpsCalloutRegister0 mendaftarkan callout dengan mesin filter.
Sintaks
NTSTATUS FwpsCalloutRegister0(
[in, out] void *deviceObject,
[in] const FWPS_CALLOUT0 *callout,
[out, optional] UINT32 *calloutId
);
Parameter
[in, out] deviceObject
Penunjuk ke objek perangkat yang sebelumnya dibuat oleh driver callout. Untuk informasi selengkapnya tentang cara driver callout membuat objek perangkat, lihat Membuat Objek Perangkat.
[in] callout
Penunjuk ke struktur FWPS_CALLOUT0 konstanta yang berisi data yang diperlukan untuk mendaftarkan callout dengan mesin filter.
[out, optional] calloutId
Penunjuk ke variabel berjenis UINT32 yang menerima pengidentifikasi run-time yang mengidentifikasi callout di mesin filter. Driver callout meneruskan pengidentifikasi ini ke fungsi FwpsCalloutUnregisterById0 saat membatalkan pendaftaran callout dari mesin filter. Jika driver callout memfilter aliran data, driver tersebut juga meneruskan pengidentifikasi ini ke fungsi FwpsFlowAssociateContext0 dan FwpsFlowRemoveContext0 . Jika driver callout menyuntikkan data ke aliran data, driver tersebut juga meneruskan pengidentifikasi ini ke fungsi FwpsStreamInjectAsync0 . Mesin filter juga meneruskan pengidentifikasi ini ke fungsi callout driver calloutDeleteFn . Parameter ini bersifat opsional dan dapat berupa NULL.
Nilai kembali
Fungsi FwpsCalloutRegister0 mengembalikan salah satu kode NTSTATUS berikut.
Menampilkan kode | Deskripsi |
---|---|
|
Callout berhasil didaftarkan dengan mesin filter. |
|
Callout tidak dapat didaftarkan ke mesin filter. Callout sudah terdaftar di mesin filter dengan pengidentifikasi yang identik dengan GUID yang ditentukan dalam anggota calloutKey dari struktur FWPS_CALLOUT0 yang ditujukkan oleh parameter callout . |
|
Terjadi kesalahan. |
Keterangan
Driver callout memanggil fungsi FwpsCalloutRegister0 untuk mendaftarkan callout dengan mesin filter. Driver callout dapat mendaftarkan callout dengan mesin filter kapan saja, bahkan jika mesin filter saat ini tidak berjalan.
Callout dan filter yang menentukan callout untuk tindakan filter dapat ditambahkan ke mesin filter sebelum driver callout mendaftarkan callout dengan mesin filter. Dalam situasi ini, filter dengan jenis tindakan FWP_ACTION_CALLOUT_TERMINATING atau FWP_ACTION_CALLOUT_UNKNOWN diperlakukan sebagai FWP_ACTION_BLOCK, dan filter dengan jenis tindakan FWP_ACTION_CALLOUT_INSPECTION diabaikan sampai callout terdaftar di mesin filter.
Driver callout membatalkan pendaftaran callout dari mesin filter dengan memanggil Fungsi FwpsCalloutUnregisterById0 atau Fungsi FwpsCalloutUnregisterByKey0 . Driver callout tidak dapat dibongkar hingga semua callout yang sebelumnya terdaftar di mesin filter telah berhasil dibatalkan pendaftarannya.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Tersedia dimulai dengan Windows Vista. |
Target Platform | Universal |
Header | fwpsk.h (termasuk Fwpsk.h) |
Pustaka | Fwpkclnt.lib |
IRQL | PASSIVE_LEVEL |