Fungsi NdisMCoSendNetBufferListsComplete (ndis.h)
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) |