Fungsi NdisFSendNetBufferListsComplete (ndis.h)

Artikel
03/01/2024

Driver filter memanggil fungsi NdisFSendNetBufferListsComplete untuk mengembalikan daftar tertaut struktur NET_BUFFER_LIST ke driver yang terlalu berlebihan dan untuk mengembalikan status akhir permintaan kirim.

Sintaks

void NdisFSendNetBufferListsComplete(
  [in] NDIS_HANDLE      NdisFilterHandle,
       PNET_BUFFER_LIST NetBufferList,
  [in] ULONG            SendCompleteFlags
);

Parameter

[in] NdisFilterHandle

Handel NDIS yang mengidentifikasi modul filter ini. NDIS meneruskan handel ke driver filter dalam panggilan ke fungsi FilterAttach .

NetBufferList

Penunjuk ke daftar struktur NET_BUFFER_LIST yang ditautkan. Driver filter menerima struktur NET_BUFFER_LIST dalam panggilan sebelumnya ke Fungsi FilterSendNetBufferLists .

[in] SendCompleteFlags

Bendera NDIS yang dapat dikombinasikan dengan operasi OR. Untuk menghapus semua bendera, atur anggota ini ke nol. Fungsi ini mendukung bendera berikut:

NDIS_SEND_COMPLETE_FLAGS_DISPATCH_LEVEL

Menentukan bahwa IRQL saat ini DISPATCH_LEVEL. Untuk informasi selengkapnya tentang bendera ini, lihat Pengiriman Pelacakan IRQL.

NDIS_SEND_COMPLETE_FLAGS_SWITCH_SINGLE_SOURCE

Jika bendera ini diatur, semua paket dalam daftar tertaut struktur NET_BUFFER_LIST berasal dari port sumber sakelar hyper-V yang dapat diperluas yang sama.

Untuk informasi selengkapnya, lihat Bendera Kirim dan Terima Sakelar Yang Dapat Diperluas Hyper-V.

Catatan Jika setiap paket dalam daftar struktur NET_BUFFER_LIST yang ditautkan menggunakan port sumber yang sama, ekstensi harus mengatur bendera NDIS_SEND_FLAGS_SWITCH_SINGLE_SOURCE dalam parameter SendFlagsNdisFSendNetBufferLists saat mengirim permintaan.

Catatan Bendera ini tersedia di NDIS 6.30 dan yang lebih baru.

Nilai kembali

Tidak ada

Keterangan

Driver filter memanggil fungsi NdisFSendNetBufferListsComplete untuk menyelesaikan permintaan pengiriman yang dibuat NDIS ke driver Fungsi FilterSendNetBufferLists . Driver filter menentukan daftar tertaut struktur NET_BUFFER_LIST yang terkait dengan permintaan pengiriman yang telah selesai. Saat status permintaan pengiriman tertunda, driver filter mempertahankan kepemilikan struktur NET_BUFFER_LIST dan semua sumber daya yang terkait dengan struktur NET_BUFFER_LIST .

Driver filter dapat menyelesaikan permintaan pengiriman dalam urutan apa pun. Misalnya, driver filter dapat menggabungkan daftar struktur NET_BUFFER_LIST dari beberapa panggilan FilterSendNetBufferLists atau membagi daftar dari panggilan FilterSendNetBufferLists . Namun, driver filter tidak boleh memodifikasi daftar struktur NET_BUFFER yang terkait dengan struktur NET_BUFFER_LIST .

Catatan Driver filter harus melacak permintaan pengiriman yang berasal darinya dan memastikan bahwa ia tidak memanggil Fungsi NdisFSendNetBufferListsComplete ketika permintaan tersebut selesai.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Didukung di NDIS 6.0 dan yang lebih baru.
Target Platform	Desktop
Header	ndis.h (termasuk Ndis.h)
Pustaka	Ndis.lib
IRQL	<= DISPATCH_LEVEL
Aturan kepatuhan DDI	Irql_Filter_Driver_Function(ndis)