FWPS_INJECT_COMPLETE0 fungsi panggilan balik (fwpsk.h)

Artikel
08/07/2023

Mesin filter memanggil fungsi calloutFn penyelesaian callout setiap kali data paket, yang dijelaskan oleh parameter netBufferList di salah satu fungsi injeksi paket, telah disuntikkan ke dalam tumpukan jaringan.

Sintaks

FWPS_INJECT_COMPLETE0 FwpsInjectComplete0;

void FwpsInjectComplete0(
  [in]      void *context,
  [in, out] NET_BUFFER_LIST *netBufferList,
  [in]      BOOLEAN dispatchLevel
)
{...}

Parameter

[in] context

Penunjuk ke parameter completionContext dari salah satu fungsi injeksi paket yang dipanggil oleh driver callout.

[in, out] netBufferList

Penunjuk diteruskan dalam parameter netBufferList dari salah satu fungsi injeksi paket yang dipanggil oleh driver callout.

[in] dispatchLevel

Nilai yang menunjukkan IRQL tempat fungsi callout completionFn dipanggil. Jika parameter ini TRUE, fungsi callout completionFn dipanggil di IRQL = DISPATCH_LEVEL. Jika parameter ini FALSE, fungsi callout completionFn dipanggil pada DISPATCH_LEVEL IRQL < .

Nilai kembali

Tidak ada

Keterangan

Jenis FWPS_INJECT_COMPLETE0 didefinisikan sebagai penunjuk ke fungsi completionFn sebagai berikut:

typedef void (NTAPI *FWPS_INJECT_COMPLETE0) completionFn

Anggota Status struktur NET_BUFFER_LIST yang ditunjukkan oleh NetBufferList menunjukkan hasil operasi injeksi.

Setelah data paket dalam rantai struktur yang dikloning atau dibuat NET_BUFFER_LIST berhasil disuntikkan ke tumpukan jaringan oleh salah satu fungsi injeksi paket, completionFn dipanggil.

Jika fungsi FwpsStreamInjectAsync0 dipanggil untuk menyuntikkan rantai struktur NET_BUFFER_LIST , completionFn akan dipanggil sekali untuk setiap NET_BUFFER_LIST dalam rantai, setiap kali menggunakan parameter completionContext yang sama yang ditentukan dalam FwpsStreamInjectAsync0. Dalam hal ini, penyelesaian driver calloutFn harus memanggil FwpsFreeCloneNetBufferList0 untuk membebaskan NET_BUFFER_LIST yang ditunjukkan saat ini.

Mesin filter memanggil fungsi callout Fn penyelesaian callout di IRQL <= DISPATCH_LEVEL.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia dimulai dengan Windows Vista.
Target Platform	Windows
Header	fwpsk.h (termasuk Fwpsk.h)
IRQL	<= DISPATCH_LEVEL