Fungsi FwpsReassembleForwardFragmentGroup0 (fwpsk.h)

Artikel
08/07/2023

Fungsi FwpsReassembleForwardFragmentGroup0 merakit daftar fragmen IP dalam jalur data penerusan ke dalam satu paket.

CatatanFwpsReassembleForwardFragmentGroup0 adalah versi spesifik dari FwpsReassembleForwardFragmentGroup. Lihat Nama Version-Independent WFP dan Menargetkan Versi Windows Tertentu untuk informasi selengkapnya.

Sintaks

NTSTATUS FwpsReassembleForwardFragmentGroup0(
  [in]           ADDRESS_FAMILY  addressFamily,
  [in, out]      NET_BUFFER_LIST *fragmentGroupNblChain,
  [in, optional] NDIS_HANDLE     netBufferAndNetBufferListPoolHandle,
  [in]           ULONG           dataBackFill,
  [in]           ULONG           flags,
  [out]          NET_BUFFER_LIST **reassembledNbl
);

Parameter

[in] addressFamily

Salah satu keluarga alamat berikut:

AF_INET

Keluarga alamat IPv4.

AF_INET6

Keluarga alamat IPv6.

[in, out] fragmentGroupNblChain

Pointer ke rantai NET_BUFFER_LIST fragmen IP untuk disusun kembali menjadi satu paket. Untuk informasi selengkapnya tentang penggunaan parameter ini, lihat Keterangan.

[in, optional] netBufferAndNetBufferListPoolHandle

Gagang kumpulan struktur NET_BUFFER_LIST opsional yang sebelumnya dikembalikan dari Fungsi NdisAllocateNetBufferListPool . Anggota fAllocateNetBuffer dari struktur NET_BUFFER_LIST_POOL_PARAMETERS yang diteruskan pemanggil ke NdisAllocateNetBufferListPool harus diatur ke TRUE, dan anggota DataSize diatur ke nol. Jika parameter ini NULL, NDIS menggunakan kumpulan internal.

[in] dataBackFill

Jika alokasi ruang data yang tidak digunakan (ruang isi ulang) diperlukan, parameter ini menentukan jumlah byte ruang data yang tidak digunakan untuk dialokasikan.

[in] flags

Dicadangkan. Driver callout harus mengatur parameter ini ke nol.

[out] reassembledNbl

Penunjuk ke penunjuk NET_BUFFER_LIST yang menerima alamat daftar buffer jaringan tunggal yang disusun ulang.

Nilai kembali

Fungsi FwpsReassembleForwardFragmentGroup0 mengembalikan salah satu kode NTSTATUS berikut.

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Daftar fragmen IP berhasil disusun ulang ke dalam satu struktur NET_BUFFER_LIST .
STATUS_FWP_TCPIP_NOT_READY	Tumpukan jaringan TCP/IP belum siap untuk melakukan rakitan ulang paket. Kesalahan ini dapat terjadi jika fungsi ini dipanggil sebelum Tcpip.sys dimuat, atau setelah Tcpip.sys dibongkar.
Kode status lainnya	Terjadi kesalahan.

Keterangan

Fungsi FwpsReassembleForwardFragmentGroup0 merakit daftar fragmen IP dalam jalur data penerusan, yang dijelaskan oleh rantai NET_BUFFER_LIST , ke dalam satu paket. Paket yang disusun ulang adalah daftar buffer bersih tunggal yang berisi satu buffer net dan mereferensikan rantai fragmen input. Fungsi ini biasanya digunakan oleh firewall tepi untuk memeriksa paket jaringan.

Rantai input fragmen IP, fragmentGroupNblChain, harus salah satu yang ditunjukkan oleh fungsi callout classifyFn ke lapisan FWPS_LAYER_IPFORWARD_V4 atau FWPS_LAYER_IPFORWARD_V6 saat bendera FWP_CONDITION_FLAG_IS_FRAGMENT_GROUP diatur. Jika tidak demikian, perilaku FwpsReassembleForwardFragmentGroup0 tidak terdefinisi.

Panggil fungsi FwpsFreeNetBufferList0 untuk membebaskan struktur NET_BUFFER_LIST FwpsFreeNetBufferList0 untuk membebaskan struktur NET_BUFFER_LIST dan semua struktur NET_BUFFER terkait dan rantai MDL. FwpsFreeNetBufferList0 mendereferensikan rantai fragmen input asli.

Anda dapat menggunakan perintah berikut untuk melihat pengaturan "Fragmen Yang Diteruskan Grup" saat ini untuk sistem: antarmuka netsh {ipv4|ipv6} tampilkan global.

Karena FwpsReassembleForwardFragmentGroup0 mereferensikan rantai fragmen input, maka tidak perlu bagi callout untuk mereferensikan atau mengkloning rantai sebelum memanggil fungsi ini.

Persyaratan

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