Fungsi FwpsCalloutRegister0 (fwpsk.h)

Artikel
03/08/2023

Fungsi FwpsCalloutRegister0 mendaftarkan callout dengan mesin filter.

CatatanFwpsCalloutRegister0 adalah versi spesifik FwpsCalloutRegister yang digunakan di Windows Vista dan yang lebih baru. Lihat Nama Version-Independent WFP dan Menargetkan Versi Windows Tertentu untuk informasi selengkapnya. Untuk Windows 8, FwpsCalloutRegister2 tersedia. Untuk Windows 7, FwpsCalloutRegister1 tersedia.

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
STATUS_SUCCESS	Callout berhasil didaftarkan dengan mesin filter.
STATUS_FWP_ALREADY_EXISTS	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 .
Kode status lainnya	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