Fungsi FwpsReferenceNetBufferList0 (fwpsk.h)

Fungsi FwpsReferenceNetBufferList0 menaikkan jumlah referensi untuk struktur NET_BUFFER_LIST .

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

 

Sintaks

void FwpsReferenceNetBufferList0(
  [in, out] NET_BUFFER_LIST *netBufferList,
  [in]      BOOLEAN         intendToModify
);

Parameter

[in, out] netBufferList

Penunjuk ke struktur NET_BUFFER_LIST tempat jumlah referensi ditambahkan.

[in] intendToModify

Nilai yang menunjukkan apakah callout berniat untuk memodifikasi daftar buffer jaringan kloning, yang induknya diacu oleh parameter netBufferList , setelah fungsi classifyFn kembali. Jika TRUE, callout berniat untuk memodifikasi daftar buffer net kloning setelah classifyFn kembali (modifikasi out-of-band). Jika tidak, atur ke FALSE.

Nilai kembali

Tidak ada

Keterangan

Driver callout memanggil fungsi FwpsReferenceNetBufferList0 untuk menambah jumlah referensi untuk struktur NET_BUFFER_LIST sehingga daftar buffer jaringan tetap valid di luar fungsi classifyFn .

Misalnya, ketika driver callout melakukan penyusunan ulang paket, driver tersebut meningkatkan jumlah referensi untuk setiap struktur NET_BUFFER_LIST yang diterima yang menjelaskan fragmen paket yang membentuk paket individual. Ini memungkinkan struktur NET_BUFFER_LIST baru yang menjelaskan paket yang disusun ulang untuk mereferensikan daftar deskriptor memori (MDL) dengan aman yang ditunjukkan oleh struktur NET_BUFFER_LIST yang menjelaskan fragmen paket. Setelah driver callout menyuntikkan struktur NET_BUFFER_LIST baru ke dalam tumpukan jaringan, driver tersebut mengurangi jumlah referensi untuk setiap struktur NET_BUFFER_LIST yang menggambarkan fragmen paket dari rutinitas penyelesaian injeksi paketnya.

Driver callout harus memanggil fungsi FwpsDereferenceNetBufferList0 untuk struktur NET_BUFFER_LIST setelah driver callout selesai mereferensikan struktur.

Panduan untuk Mengelola Paket yang Dirujuk

Driver callout tidak boleh menyimpan paket yang dirujuk tanpa batas waktu. Paket yang dirujuk dapat mengganggu operasi manajemen daya pada komputer yang tidak aktif.

Penggunaan yang dimaksudkan untuk paket yang dirujuk di WFP adalah untuk mendapatkan klarifikasi dari aplikasi mode pengguna atau operasi lain yang relatif cepat. Driver callout tidak boleh menyimpan paket yang direferensikan sementara, misalnya, menunggu input pengguna, izin layanan web, atau operasi lain yang mungkin memakan waktu seadanya.

Jika driver callout harus menunggu operasi yang berpotensi panjang, itu harus membuat salinan mendalam paket menggunakan FwpsAllocateNetBufferAndNetBufferList0 dan memblokir dan menyerap paket asli.

Driver callout harus selalu mengembalikan paket yang ditahan secepat mungkin.

Persyaratan

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

Lihat juga

FwpsDereferenceNetBufferList0

NET_BUFFER_LIST

classifyFn