Fungsi NdisMCoSendNetBufferListsComplete (ndis.h)

Artikel
08/07/2023

Fungsi NdisMCoSendNetBufferListsComplete mengembalikan daftar tertaut struktur NET_BUFFER_LIST ke driver yang terlalu berlebihan dan mengembalikan status akhir permintaan pengiriman CoNDIS.

Sintaks

void NdisMCoSendNetBufferListsComplete(
  [in] IN NDIS_HANDLE      NdisVcHandle,
  [in] IN PNET_BUFFER_LIST NetBufferLists,
  [in] IN ULONG            SendCompleteFlags
);

Parameter

[in] NdisVcHandle

Handel yang mengidentifikasi koneksi virtual (VC). Driver miniport memperoleh handel ini sebagai parameter input ke fungsi MiniportCoCreateVc-nya , baik ketika klien menyiapkan panggilan keluar atau ketika manajer panggilan membuat VC untuk titik akses layanan terdaftar klien (SAP) untuk menunjukkan pemberitahuan panggilan masuk.

[in] NetBufferLists

Penunjuk ke daftar struktur NET_BUFFER_LIST yang ditautkan. Driver miniport menerima struktur NET_BUFFER_LIST dalam panggilan sebelumnya Fungsi MiniportCoSendNetBufferLists .

[in] SendCompleteFlags

Bendera NDIS yang dapat dikombinasikan dengan operasi OR bitwise. Untuk menghapus semua bendera, atur parameter ini ke nol. NdisMCoSendNetBufferListsComplete mendukung bendera NDIS_SEND_COMPLETE_FLAGS_DISPATCH_LEVEL, yang; jika diatur, menunjukkan bahwa IRQL saat ini DISPATCH_LEVEL. Untuk informasi selengkapnya tentang bendera ini, lihat Pengiriman Pelacakan IRQL.

Nilai kembali

Tidak ada

Keterangan

Driver miniport memanggil NdisMCoSendNetBufferListsComplete untuk menyelesaikan permintaan pengiriman yang dibuat NDIS ke driver Fungsi MiniportCoSendNetBufferLists . Driver miniport menentukan daftar tertaut struktur NET_BUFFER_LIST yang terkait dengan permintaan pengiriman yang telah selesai.

Saat status permintaan pengiriman tertunda, driver miniport mempertahankan kepemilikan struktur NET_BUFFER_LIST dan semua sumber daya yang terkait dengan struktur NET_BUFFER_LIST.

Setelah driver miniport memanggil NdisMCoSendNetBufferListsComplete, NDIS mengembalikan struktur NET_BUFFER_LIST dan data terkait ke driver yang terlalu berlebihan yang berasal dari permintaan pengiriman.

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

Driver miniport harus mengatur salah satu kode status berikut dalam anggota Status dari setiap struktur NET_BUFFER_LIST yang ditentukan parameter NetBufferLists :

Panggilan driver miniport ke NdisMCoSendNetBufferListsComplete tidak selalu menunjukkan bahwa data untuk permintaan pengiriman telah dikirimkan melalui jaringan. Misalnya, data mungkin diantrekan di perangkat keras NIC.

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_MCO_Function(ndis)