FWPS_NET_BUFFER_LIST_NOTIFY_FN1 fungsi panggilan balik (fwpsk.h)

Artikel
02/26/2024

Mesin filter memanggil fungsi callout FWPS_NET_BUFFER_LIST_NOTIFY_FN1 untuk memberi tahu driver callout tentang peristiwa yang terkait dengan paket yang ditandai oleh callout.

Catatan FWPS_NET_BUFFER_LIST_NOTIFY_FN1 adalah versi spesifik FWPS_NET_BUFFER_LIST_NOTIFY_FN yang digunakan dalam Windows 8 dan yang lebih baru. Lihat Nama Version-Independent WFP dan Menargetkan Versi Windows Tertentu untuk informasi selengkapnya. Untuk Windows 7, FWPS_NET_BUFFER_LIST_NOTIFY_FN0 tersedia.

Sintaks

FWPS_NET_BUFFER_LIST_NOTIFY_FN1 FwpsNetBufferListNotifyFn1;

NTSTATUS FwpsNetBufferListNotifyFn1(
  [in]                FWPS_NET_BUFFER_LIST_EVENT_TYPE0 eventType,
  [in, out]           NET_BUFFER_LIST *netBufferList,
  [in, out, optional] NET_BUFFER_LIST *newNetBufferList,
  [in]                UINT16 layerId,
  [in]                UINT64 context,
  [in]                UINT64 contextTag
)
{...}

Parameter

[in] eventType

Nilai yang menunjukkan jenis pemberitahuan yang dikirim mesin filter ke callout. Parameter ini akan diatur ke salah satu nilai FWPS_NET_BUFFER_LIST_EVENT_TYPE0 enumerasi.

[in, out] netBufferList

Penunjuk ke daftar buffer yang berisi paket yang sebelumnya ditandai sebagai menarik oleh driver callout.

[in, out, optional] newNetBufferList

Penunjuk ke daftar buffer yang diperbarui yang berisi paket yang menarik bagi driver callout. Penggunaan parameter ini berbeda tergantung pada jenis peristiwa. Untuk peristiwa di mana perubahan dilakukan pada paket yang ditunjukkan, versi yang diubah diteruskan sebagai parameter ini.

[in] layerId

Lapisan tempat fungsi pemberitahuan dipanggil.

[in] context

Konteks yang digunakan untuk menandai paket yang diminati. Nilai ini adalah nilai yang ditetapkan ke paket oleh driver callout dan digunakan untuk mengidentifikasi paket.

[in] contextTag

Tag konteks yang digunakan untuk mengaitkan paket yang menarik dengan konteks driver callout.

Nilai kembali

Callout FWPS_NET_BUFFER_LIST_NOTIFY_FN1 mengembalikan salah satu kode NTSTATUS berikut.

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Driver callout menerima pemberitahuan dari mesin filter.
Kode status lainnya	Terjadi kesalahan.

Keterangan

Fungsi ini dikaitkan dengan driver callout dengan panggilan ke FwpsNetBufferListAssociateContext1. Driver callout dapat menggunakan fungsi pemberitahuan tunggal untuk menangani pesan untuk beberapa daftar buffer terkait dengan menggunakan konteks dan tag konteks untuk membedakan antar instans.

Fungsi ini identik dengan FWPS_NET_BUFFER_LIST_NOTIFY_FN0, kecuali bahwa jenis pengembalian adalah NTSTATUS alih-alih VOID.

Persyaratan

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