Fungsi FwpsNetBufferListAssociateContext0 (fwpsk.h)

Artikel
02/29/2024

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

CatatanFwpsNetBufferListAssociateContext0 adalah versi spesifik FwpsNetBufferListAssociateContext 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, FwpsNetBufferListAssociateContext1 tersedia.

Sintaks

NTSTATUS FwpsNetBufferListAssociateContext0(
  [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_FN0 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_FN0.

[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 driver callout FWPS_NET_BUFFER_LIST_NOTIFY_FN0 fungsi. 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 FwpsNetBufferListAssociateContext0 mengembalikan salah satu kode NTSTATUS berikut.

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

Keterangan

Fungsi FwpsNetBufferListAssociateContext0 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.

Persyaratan

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

Lihat juga

FwpsNetBufferListAssociateContext1

FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRemoveContext0 FwpsNetBufferListRetrieveContext0

NET_BUFFER_LIST

Menggunakan Pemberian Tag Paket

Share via