Fungsi FwpsNetBufferListAssociateContext1 (fwpsk.h)

Artikel
02/26/2024

Fungsi FwpsNetBufferListAssociateContext1 mengaitkan konteks driver callout dengan daftar buffer jaringan dan mengonfigurasi pemberitahuan untuk peristiwa daftar buffer jaringan.

CatatanFwpsNetBufferListAssociateContext1 adalah versi spesifik FwpsNetBufferListAssociateContext yang digunakan di Windows 8 dan yang lebih baru. Lihat Nama Version-Independent WFP dan Menargetkan Versi Windows Tertentu untuk informasi selengkapnya. Untuk Windows 7, FwpsNetBufferListAssociateContext0 tersedia.

Sintaks

NTSTATUS FwpsNetBufferListAssociateContext1(
  [in, out] NET_BUFFER_LIST                 *netBufferList,
  [in]      UINT16                          layerId,
  [in]      UINT64                          context,
  [in]      UINT64                          contextTag,
            GUID                            *providerGuid,
  [in, out] void                            *deviceObject,
  [in]      FWPS_NET_BUFFER_LIST_NOTIFY_FN1 notifyFn,
  [in]      UINT32                          flags
);

Parameter

[in, out] netBufferList

Daftar buffer jaringan yang menunjukkan satu atau beberapa paket yang menarik bagi driver callout.

[in] layerId

Pengidentifikasi lapisan tempat konteks dikaitkan. Saat memanggil fungsi ini dari jalur penerima NDIS, atur parameter ini ke FWPS_LAYER_NON_WFP.

[in] context

Informasi konteks arbitrer yang ditetapkan oleh driver callout. Mesin filter akan meneruskan konteks ini ke driver callout
FWPS_NET_BUFFER_LIST_NOTIFY_FN1 fungsi.

[in] contextTag

Pengidentifikasi unik lokal yang diperoleh dengan memanggil Fungsi FwpsNetBufferListGetTagForContext0 .

providerGuid

GUID penyedia.

[in, out] deviceObject

Penunjuk ke objek perangkat driver callout.

[in] notifyFn

Penunjuk ke fungsi FWPS_NET_BUFFER_LIST_NOTIFY_FN1 driver callout. Mesin filter akan mengirim pemberitahuan status ke fungsi ini.

[in] flags

Parameter ini dicadangkan untuk digunakan di masa mendatang dan diatur ke nol.

Nilai kembali

Fungsi FwpsNetBufferListAssociateContext1 mengembalikan salah satu kode NTSTATUS berikut.

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Asosiasi berhasil.
Kode status lainnya	Terjadi kesalahan.

Keterangan

Fungsi FwpsNetBufferListAssociateContext1 mengaitkan grup paket dengan driver callout. Paket yang menarik dapat dilacak untuk diperiksa melalui beberapa lapisan dalam tumpukan.

Sebelum memanggil fungsi ini, fungsi FwpsNetBufferListGetTagForContext0 harus dipanggil untuk mendapatkan tag konteks.

Fungsi ini pada dasarnya identik dengan versi sebelumnya,

FwpsNetBufferListAssociateContext0. Satu-satunya perbedaan adalah fungsi FWPS_NET_BUFFER_LIST_NOTIFY_FN1 yang diperbarui yang diacu oleh parameter notifyFn .

Persyaratan

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