Fungsi FwpsNetBufferListRemoveContext0 (fwpsk.h)

Artikel
02/26/2024

Fungsi FwpsNetBufferListRemoveContext0 menghapus konteks yang terkait dengan daftar buffer jaringan.

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

Sintaks

NTSTATUS FwpsNetBufferListRemoveContext0(
  [in, out, optional] NET_BUFFER_LIST *netBufferList,
  [in]                UINT64          contextTag,
  [in]                UINT32          flags
);

Parameter

[in, out, optional] netBufferList

Daftar buffer jaringan yang menunjukkan satu atau beberapa paket yang menarik bagi driver callout. Parameter ini bersifat opsional dan dapat berupa NULL. Jika NULL, fungsi akan menghapus konteks dari semua daftar buffer jaringan terkait.

[in] contextTag

Tag konteks yang diteruskan dalam parameter contextTag ke FwpsNetBufferListAssociateContext0.

[in] flags

Parameter ini dicadangkan untuk digunakan di masa mendatang dan harus nol.

Nilai kembali

Fungsi FwpsNetBufferListRemoveContext0 mengembalikan salah satu kode NTSTATUS berikut.

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Konteks berhasil dihapus.
Kode status lainnya	Terjadi kesalahan.

Keterangan

Fungsi FwpsNetBufferListRemoveContext0 secara asinkron menghapus konteks yang diberi tag yang terkait dengan daftar buffer jaringan.

Untuk mengaitkan konteks dengan daftar buffer jaringan, panggil FwpsNetBufferListAssociateContext0 atau FwpsNetBufferListAssociateContext1.

Biasanya driver callout tidak perlu menggunakan fungsi ini, karena konteks yang ditandai dihapus secara otomatis ketika paket bergerak melalui tumpukan. Fungsi ini disediakan sehingga driver callout dapat berhenti memproses dalam situasi di mana konteks tidak dihapus secara otomatis. Misalnya, dalam kasus driver filter NDIS, paket tidak pernah memasukkan tumpukan TCP/IP, dan konteks harus dihapus secara manual dengan memanggil FwpsNetBufferListRemoveContext0 dengan parameter netBufferList diatur ke NULL.

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