Fungsi FwpsCloneStreamData0 (fwpsk.h)

Artikel
08/07/2023

Fungsi FwpsCloneStreamData0 mengalokasikan kloning aliran data FWPS_STREAM_DATA0 yang ada.

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

Sintaks

NTSTATUS FwpsCloneStreamData0(
  [in, out]      FWPS_STREAM_DATA0 *calloutStreamData,
  [in, optional] NDIS_HANDLE       netBufferListPoolHandle,
  [in, optional] NDIS_HANDLE       netBufferPoolHandle,
  [in]           ULONG             allocateCloneFlags,
  [out]          NET_BUFFER_LIST   **netBufferListChain
);

Parameter

[in, out] calloutStreamData

Penunjuk ke struktur FWPS_STREAM_DATA0 asli yaitu struktur NET_BUFFER_LIST dikloning.

[in, optional] netBufferListPoolHandle

Handel kumpulan NET_BUFFER_LIST yang diperoleh dari panggilan sebelumnya ke fungsi NdisAllocateNetBufferListPool . Parameter ini bersifat opsional dan dapat berupa NULL.

[in, optional] netBufferPoolHandle

Handel kumpulan NET_BUFFER yang diperoleh dari panggilan sebelumnya ke Fungsi NdisAllocateNetBufferPool . Parameter ini bersifat opsional dan dapat berupa NULL.

[in] allocateCloneFlags

Saat ini tidak ada bendera yang ditentukan untuk fungsi ini. Driver callout harus mengatur parameter ini ke nol.

[out] netBufferListChain

Penunjuk ke lokasi yang menerima pointer ke rantai struktur NET_BUFFER_LIST yang menjelaskan semua data aliran kloning.

Nilai kembali

Fungsi FwpsCloneStreamData0 mengembalikan salah satu kode NTSTATUS berikut.

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Struktur kloning FWPS_STREAM_DATA0 berhasil dialokasikan.
Kode status lainnya	Terjadi kesalahan.

Keterangan

Data aliran kloning ini dapat disuntikkan oleh driver callout ke tumpukan jaringan TCP/IP di lain waktu.

Fungsi FwpsCloneStreamData0 mengkloning seluruh rantai struktur NET_BUFFER_LIST yang terkandung dalam aliran data FWPS_STREAM_DATA0 yang ada. Fungsi memangkas data yang tidak digunakan sedemikian rupa sehingga driver callout dapat berhasil meneruskan rantai kloning ke Fungsi FwpsStreamInjectAsync0 .

Setelah aliran data dalam kloning NET_BUFFER_LIST rantai struktur telah berhasil disuntikkan ke tumpukan jaringan, fungsi callout completionFn dipanggil untuk setiap kloning struktur NET_BUFFER_LIST, dan callout harus memanggil FwpsFreeCloneNetBufferList0 untuk membebaskan struktur kloning NET_BUFFER_LIST.

Callout harus memanggil fungsi FwpsDiscardClonedStreamData0 jika data aliran kloning akan dibuang tanpa disuntikkan kembali.

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