struktur FWPS_STREAM_CALLOUT_IO_PACKET0 (fwpsk.h)

Artikel
08/07/2023

Struktur FWPS_STREAM_CALLOUT_IO_PACKET0 menjelaskan data yang diteruskan oleh mesin filter ke fungsi callout classifyFn saat memfilter aliran data.

CatatanFWPS_STREAM_CALLOUT_IO_PACKET0 adalah versi FWPS_STREAM_CALLOUT_IO_PACKET tertentu. Lihat Nama Version-Independent WFP dan Menargetkan Versi Windows Tertentu untuk informasi selengkapnya.

Sintaks

typedef struct FWPS_STREAM_CALLOUT_IO_PACKET0_ {
  FWPS_STREAM_DATA0       *streamData;
  SIZE_T                  missedBytes;
  UINT32                  countBytesRequired;
  SIZE_T                  countBytesEnforced;
  FWPS_STREAM_ACTION_TYPE streamAction;
} FWPS_STREAM_CALLOUT_IO_PACKET0;

Anggota

streamData

Penunjuk ke struktur FWPS_STREAM_DATA0 yang menjelaskan bagian aliran data yang tersedia untuk fungsi callout classifyFn driver callout untuk diproses.

missedBytes

Jumlah byte dalam aliran data yang hilang sejak terakhir kali fungsi callout driver callout mengklasifikasikanFn callout dipanggil. Anggota ini bukan nol jika filter bobot yang lebih tinggi di mesin filter mencegah fungsi callout driver callout mengklasifikasikanFn callout dari pemrosesan sebagian aliran data.

countBytesRequired

Nilai yang ditetapkan oleh fungsi callout classifyFn callout. Nilai ini menentukan berapa banyak byte tambahan data aliran yang diperlukan oleh fungsi callout jika mengatur anggota streamAction ke FWPS_STREAM_ACTION_NEED_MORE_DATA. Mesin filter menunggu hingga menerima setidaknya banyak byte tambahan data aliran ini sebelum memanggil fungsi callout classifyFn driver callout lagi.

Jika fungsi callout classifyFn callout menetapkan anggota streamAction ke nilai selain FWPS_STREAM_ACTION_NEED_MORE_DATA, maka itu harus mengatur anggota ini ke nol.

countBytesEnforced

Nilai yang ditetapkan oleh fungsi callout classifyFn callout. Nilai ini menentukan jumlah byte data terkemuka dalam bagian aliran data yang sedang diproses di mana tindakan yang ditentukan oleh anggota streamAction atau oleh tindakan yang dikembalikan oleh fungsi callout berlaku. Setiap data yang tersisa dalam buffer aliran akan diteruskan ke driver callout lagi saat mesin filter memanggil fungsi callout driver calloutfn.

streamAction

Nilai FWPS_STREAM_ACTION_TYPE yang ditetapkan oleh fungsi callout classifyFn callout yang menentukan tindakan yang akan diterapkan ke aliran data. Tindakan ini tidak bergantung pada tindakan yang dikembalikan oleh fungsi callout. Fungsi callout classifyFn callout menetapkan anggota ini ke salah satu hal berikut:

FWPS_STREAM_ACTION_NONE

Tidak diperlukan tindakan khusus aliran.

FWPS_STREAM_ACTION_ALLOW_CONNECTION

Menunjukkan bahwa semua segmen data di masa mendatang milik alur diizinkan. Dalam hal ini, WFP berhenti mengklasifikasikan segmen data apa pun ke callout dan mencoba untuk membongkar aliran ke perangkat keras sehingga tidak ada lagi overhead inspeksi yang dikeluarkan.

FWPS_STREAM_ACTION_NEED_MORE_DATA

Lebih banyak data streaming diperlukan oleh fungsi callout.

FWPS_STREAM_ACTION_DROP_CONNECTION

Koneksi aliran harus dihilangkan. Fungsi callout classifyFn callout hanya boleh mengatur anggota streamAction ke nilai ini jika anggota action.type dari struktur FWPS_FILTER0 yang diteruskan mesin filter ke fungsi calloutifyFn driver callout berisi nilai FWP_ACTION_CALLOUT_UNKNOWN. Jika fungsi callout classifyFn callout mengatur anggota streamAction ke nilai ini saat anggota action.type dari struktur FWPS_FILTER0 berisi nilai FWP_ACTION_CALLOUT_INSPECTION, koneksi tidak akan dihilangkan.

FWPS_STREAM_ACTION_DEFER

Pemrosesan data aliran akan ditangguhkan hingga driver callout memanggil fungsi FwpsStreamContinue0 . Tindakan ini hanya dapat diatur untuk aliran data masuk.

Menunda aliran data masuk akan menyebabkan tumpukan jaringan berhenti mengakui data yang diterima dari pengirim. Ini akan menyebabkan pengurangan ukuran jendela TCP geser. Driver callout dapat menggunakan perilaku ini untuk menerapkan kontrol alur untuk memperlambat laju data masuk.

Nilai FWPS_STREAM_ACTION_TYPE_MAX adalah nilai maksimum untuk tujuan pengujian.

Jika fungsi callout classifyFn callout menetapkan anggota ini ke nilai selain FWPS_STREAM_ACTION_NONE, maka tindakan yang dikembalikan oleh fungsi callout diabaikan oleh mesin filter.

Keterangan

Mesin filter meneruskan penunjuk ke struktur FWPS_STREAM_CALLOUT_IO_PACKET0 ke fungsi callout classifyFn callout sebagai parameter layerData saat memfilter aliran data.