FWPS_CALLOUT_NOTIFY_FN2 fungsi panggilan balik (fwpsk.h)
Mesin filter memanggil fungsi callout callout Callout untuk memberi tahu driver callout tentang peristiwa yang terkait dengan callout.
Sintaks
FWPS_CALLOUT_NOTIFY_FN2 FwpsCalloutNotifyFn2;
NTSTATUS FwpsCalloutNotifyFn2(
[in] FWPS_CALLOUT_NOTIFY_TYPE notifyType,
[in] const GUID *filterKey,
[in, out] FWPS_FILTER2 *filter
)
{...}
Parameter
[in] notifyType
Nilai yang menunjukkan jenis pemberitahuan yang dikirim mesin filter ke callout. Nilai yang valid untuk parameter ini adalah:
FWPS_CALLOUT_NOTIFY_ADD_FILTER
Filter sedang ditambahkan ke mesin filter yang menentukan callout untuk tindakan filter.
FWPS_CALLOUT_NOTIFY_DELETE_FILTER
Filter sedang dihapus dari mesin filter yang menentukan callout untuk tindakan filter.
FWPS_CALLOUT_NOTIFY_TYPE_MAX
Nilai maksimum untuk tujuan pengujian.
[in] filterKey
Penunjuk ke pengidentifikasi manajemen untuk filter, seperti yang ditentukan oleh aplikasi atau driver yang menambahkan atau menghapus filter. Harus NULL jika parameter notifyType diatur ke FWPS_CALLOUT_NOTIFY_DELETE_FILTER. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.
[in, out] filter
Penunjuk ke struktur FWPS_FILTER2 . Struktur ini menjelaskan filter yang ditambahkan ke atau dihapus dari mesin filter.
Fungsi notifyFn2 driver callout dapat mengatur anggota Konteks struktur ini untuk menunjuk ke struktur konteks yang disediakan driver callout saat filter ditambahkan ke mesin filter. Struktur konteks ini buram ke mesin filter, dan dapat digunakan oleh fungsi callout classifyFn2 driver callout untuk mempertahankan data khusus driver atau informasi status antara panggilan oleh mesin filter ke driver callout
fungsi callout classifyFn2.
Fungsi notifyFn2 driver callout dapat membersihkan konteks apa pun yang terkait dengan filter saat filter dihapus dari mesin filter.
Nilai kembali
Fungsi callout notifyFn2 mengembalikan salah satu kode NTSTATUS berikut.
Menampilkan kode | Deskripsi |
---|---|
|
Driver callout menerima pemberitahuan dari mesin filter. |
|
Terjadi kesalahan. Jika parameter notifyType FWPS_CALLOUT_NOTIFY_ADD_FILTER, filter tidak akan ditambahkan ke mesin filter. Jika parameter notifyType FWPS_CALLOUT_NOTIFY_DELETE_FILTER, filter akan tetap dihapus dari mesin filter. |
Keterangan
Driver callout mendaftarkan fungsi callout callout dengan mesin filter dengan memanggil fungsi FwpsCalloutRegister2 .
Mesin filter memanggil fungsi notifyFn2 driver callout untuk memberi tahu driver callout tentang peristiwa yang terkait dengan callout. Jika fungsi driver callout notifyFn2 tidak mengenali jenis pemberitahuan yang diteruskan dalam parameter notifyType , itu harus mengabaikan pemberitahuan dan mengembalikan STATUS_SUCCESS.
Jika driver callout mendaftarkan callout dengan mesin filter setelah filter yang menentukan callout untuk tindakan filter telah ditambahkan ke mesin filter, mesin filter tidak memanggil fungsi callout driver's notifyFn2 untuk memberi tahu callout tentang salah satu filter yang ada. Mesin filter memanggil fungsi notifyFn2 driver callout untuk memberi tahu callout saat filter baru yang menentukan callout untuk tindakan filter ditambahkan ke mesin filter. Dalam situasi ini, fungsi callout notifyFn2 mungkin tidak dipanggil untuk setiap filter di mesin filter yang menentukan callout untuk tindakan filter. Jika driver callout mendaftarkan callout setelah mesin filter dimulai dan callout perlu mengetahui tentang setiap filter di mesin filter yang menentukan callout untuk tindakan filter, driver callout harus memanggil fungsi manajemen yang sesuai untuk menghitung semua filter di mesin filter dan mengurutkan melalui daftar filter yang dihasilkan untuk menemukan yang menentukan panggilan untuk tindakan filter. Lihat Memanggil Fungsi Platform Pemfilteran Windows Lainnya untuk informasi selengkapnya tentang memanggil fungsi-fungsi ini.
Saat filter yang menentukan callout untuk tindakan filter dihapus dari mesin filter, mesin filter memanggil fungsi notifyFn2 driver callout dan meneruskan FWP_CALLOUT_NOTIFY_DELETE_FILTER dalam parameter notifyType dan NULL dalam parameter filterKey . Untuk informasi selengkapnya, lihat Memproses Beri Tahu Callout.
Fungsi ini pada dasarnya identik dengan versi sebelumnya, beri tahuFn1. Satu-satunya perbedaan adalah struktur FWPS_FILTER2 yang diperbarui yang ditujukkan oleh parameter filter .
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Tersedia dimulai dengan Windows 8. |
Target Platform | Windows |
Header | fwpsk.h (termasuk Fwpsk.h) |
IRQL | <= DISPATCH_LEVEL |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk