Fungsi FwpsNetBufferListRetrieveContext0 (fwpsk.h)

Artikel
08/07/2023

Fungsi FwpsNetBufferListRetrieveContext0 mengambil konteks yang terkait dengan daftar buffer jaringan yang ditandai di lapisan lain.

CatatanFwpsNetBufferListRetrieveContext0 adalah versi tertentu dari FwpsNetBufferListRetrieveContext. Lihat Nama Version-Independent WFP dan Menargetkan Versi Windows Tertentu untuk informasi selengkapnya.

Sintaks

NTSTATUS FwpsNetBufferListRetrieveContext0(
  [in, out] NET_BUFFER_LIST *netBufferList,
  [in]      UINT64          contextTag,
  [in]      BOOLEAN         removeContext,
  [in]      UINT32          flags,
  [out]     UINT64          *context
);

Parameter

[in, out] netBufferList

Daftar buffer jaringan yang menunjukkan satu atau beberapa paket yang menarik bagi driver callout. Jika removeContext diatur, daftar buffer jaringan yang dikembalikan akan menghapus konteks.

[in] contextTag

Pengidentifikasi unik lokal yang diperoleh dengan memanggil Fungsi FwpsNetBufferListGetTagForContext0 . Ini adalah tag konteks yang digunakan dalam panggilan awal ke FwpsNetBufferListAssociateContext0.

[in] removeContext

Jika diatur, FwpsNetBufferListRetrieveContext0 akan menghapus asosiasi konteks selain mengambil konteks.

[in] flags

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

[out] context

Konteks yang ditetapkan ke paket oleh driver callout dalam panggilan awal ke FwpsNetBufferListAssociateContext0.

Nilai kembali

Fungsi FwpsNetBufferListRetrieveContext0 mengembalikan salah satu kode NTSTATUS berikut.

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

Keterangan

Fungsi FwpsNetBufferListRetrieveContext0 mengambil daftar buffer jaringan yang ditandai di lapisan lain.

Anda juga dapat menggunakan fungsi ini untuk menghapus asosiasi konteks dengan mengatur parameter removeContext .

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

FwpsNetBufferListAssociateContext0 FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRemoveContext0

NET_BUFFER_LIST

Share via