struktur FWPS_CALLOUT1 (fwpsk.h)

Artikel
08/07/2023

Struktur FWPS_CALLOUT1 menentukan data yang diperlukan bagi driver callout untuk mendaftarkan callout dengan mesin filter.

CatatanFWPS_CALLOUT1 adalah versi spesifik FWPS_CALLOUT yang digunakan di Windows 7 dan yang lebih baru. Lihat Nama Version-Independent WFP dan Menargetkan Versi Windows Tertentu untuk informasi selengkapnya. Untuk Windows 8, FWPS_CALLOUT2 tersedia. Untuk Windows Vista, FWPS_CALLOUT0 tersedia.

Sintaks

typedef struct FWPS_CALLOUT1_ {
  GUID                                calloutKey;
  UINT32                              flags;
  FWPS_CALLOUT_CLASSIFY_FN1           classifyFn;
  FWPS_CALLOUT_NOTIFY_FN1             notifyFn;
  FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0 flowDeleteFn;
} FWPS_CALLOUT1;

Anggota

calloutKey

GUID yang ditentukan driver callout yang secara unik mengidentifikasi callout.

flags

Bendera yang menentukan parameter khusus callout. Bendera yang mungkin adalah:

Nilai	Makna
FWP_CALLOUT_FLAG_CONDITIONAL_ON_FLOW 0x00000001	Driver callout dapat menentukan bendera ini saat mendaftarkan callout yang akan ditambahkan pada lapisan yang mendukung aliran data. Jika bendera ini ditentukan, mesin filter memanggil fungsi callout driver callout classifyFn1 hanya jika ada konteks yang terkait dengan aliran data. Driver callout mengaitkan konteks dengan aliran data dengan memanggil fungsi FwpsFlowAssociateContext0 .
FWP_CALLOUT_FLAG_ALLOW_OFFLOAD 0x00000002	Driver callout menentukan bendera ini untuk menunjukkan bahwa fungsi callout classifyFn1 driver callout tidak terpengaruh dengan membongkar pemrosesan data jaringan ke kartu antarmuka jaringan (NIC) berkemampuan offload. Jika bendera ini tidak ditentukan, maka offloading pemrosesan data jaringan dinonaktifkan untuk semua lalu lintas yang diproses oleh filter apa pun yang menentukan callout untuk tindakan filter.
FWP_CALLOUT_FLAG_ENABLE_COMMIT_ADD_NOTIFY 0x00000004	Driver callout menentukan bendera ini untuk menunjukkan bahwa ia dapat menerima pemberitahuan tentang objek dan filter yang ditambahkan di dalam transaksi. Mesin filter mengirimkan pemberitahuan setelah transaksi dilakukan.
FWP_CALLOUT_FLAG_ALLOW_MID_STREAM_INSPECTION 0x00000008	Driver callout menentukan bendera ini untuk menunjukkan bahwa ia dapat melakukan inspeksi aliran dinamis aliran data pada tingkat aliran. Lihat Inspeksi Stream.
FWP_CALLOUT_FLAG_ALLOW_RECLASSIFY 0x00000010	Driver callout menentukan bendera ini untuk mendaftarkan dirinya untuk dipanggil ketika operasi soket yang ada diklasifikasi ulang.

classifyFn

Penunjuk ke fungsi callout classifyFn1 driver callout. Mesin filter memanggil fungsi ini setiap kali ada data jaringan yang akan diproses oleh callout.

notifyFn

Penunjuk ke fungsi notifyFn1 driver callout. Mesin filter memanggil fungsi ini untuk memberi tahu driver callout tentang peristiwa yang terkait dengan callout.

flowDeleteFn

Penunjuk ke fungsi callout flowDeleteFn driver callout. Mesin filter memanggil fungsi ini setiap kali aliran data yang sedang diproses oleh callout dihentikan.

Jika driver callout tidak mengaitkan konteks dengan aliran data yang diproses callout, maka anggota ini harus diatur ke NULL.

Keterangan

Driver callout meneruskan pointer ke struktur FWPS_CALLOUT1 yang diinisialisasi ke fungsi FwpsCalloutRegister1 saat mendaftarkan callout dengan mesin filter.

Callout dapat mengatur bendera FWP_CALLOUT_FLAG_CONDITIONAL_ON_FLOW hanya untuk koneksi tempat driver tertarik untuk melakukan inspeksi streaming. Callout ini akan diabaikan pada semua koneksi lainnya. Performa akan ditingkatkan dan driver tidak perlu mempertahankan data status yang tidak perlu.

Struktur ini pada dasarnya identik dengan versi sebelumnya, FWPS_CALLOUT0. Satu-satunya perbedaan adalah bahwa anggota versi ini menyimpan versi terbaru dari penunjuk fungsi callout, dan bendera tambahan tersedia untuk diatur oleh driver callout.