Fungsi NdisCancelSendPackets (ndis.h)

  • Artikel

Catatan NDIS 5. x telah tidak digunakan lagi dan digantikan oleh NDIS 6. x. Untuk pengembangan driver NDIS baru, lihat Driver Jaringan Yang Dimulai dengan Windows Vista. Untuk informasi tentang port NDIS 5. x driver ke NDIS 6. x, lihat Memindahkan Driver NDIS 5.x ke NDIS 6.0.

NdisCancelSendPackets membatalkan transmisi semua paket yang ditandai dengan pengidentifikasi pembatalan yang ditentukan pada driver miniport yang diidentifikasi oleh handel pengikatan.

Sintaks

void NdisCancelSendPackets(
  [in] NDIS_HANDLE NdisBindingHandle,
  [in] PVOID       CancelId
);

Parameter

[in] NdisBindingHandle

Menentukan handel yang dikembalikan oleh NdisOpenAdapter yang mengidentifikasi NIC atau adaptor virtual tempat pembatalan berlaku.

[in] CancelId

Arahkan ke pengidentifikasi pembatalan. Pengidentifikasi ini menentukan paket atau grup paket tempat transmisi dibatalkan.

Nilai kembali

Tidak ada

Keterangan

Protokol transportasi memetakan RUN yang diterima dari perangkat lunak tingkat lebih tinggi ke paket NDIS, yang kemudian dikirim protokol ke driver tingkat bawah untuk transmisi. Jika IRP dibatalkan, protokol transportasi dapat memanggil fungsi NdisCancelSendPackets untuk membatalkan transmisi paket NDIS yang sesuai yang tertunda.

Fungsi NdisCancelSendPackets membatalkan transmisi paket pada satu pengikatan. Untuk membatalkan transmisi paket pada lebih dari satu pengikatan, protokol atau driver perantara harus memanggil fungsi NdisCancelSendPackets sekali untuk setiap pengikatan.

Protokol atau driver perantara harus memastikan bahwa NdisBindingHandle, yang mewakili pengikatan driver ke adaptor, tetap berlaku selama durasi panggilan ke NdisCancelSendPackets. Artinya, protokol atau driver perantara tidak boleh memanggil fungsi NdisCloseAdapter untuk menutup pengikatan sebelum NdisCancelSendPackets kembali.

Tidak ada jaminan bahwa memanggil NdisCancelSendPackets akan membatalkan transmisi yang tertunda dari semua paket dengan ID pembatalan yang ditentukan. Misalnya, jika driver berikutnya yang lebih rendah di mana protokol atau driver perantara terikat tidak menyediakan fungsi MiniportCancelSendPackets , panggilan ke NdisCancelSendPackets tidak melakukan apa-apa.

Dalam semua kasus, paket yang dikirimkan untuk transmisi dikembalikan ke protokol asal atau driver perantara melalui panggilan ke fungsi ProtocolSendComplete atau ProtocolCoSendComplete driver. Paket pengiriman yang dibatalkan dikembalikan dengan status penyelesaian NDIS_STATUS_ABORTED. Penundaan antara memanggil NdisCancelSendPackets dan pengembalian paket yang dibatalkan dapat bervariasi dan karenanya tidak dapat ditentukan dengan tepat.

  • Platform target: Universal
  • Versi: Tidak didukung untuk driver NDIS 6.0 di Windows Vista. Gunakan NdisCancelSendNetBufferLists sebagai gantinya. Didukung untuk driver NDIS 5.1 di Windows Vista dan Windows XP.

Persyaratan

Persyaratan Nilai
Header ndis.h (termasuk Ndis.h)
Pustaka Ndis.lib
IRQL IRQL <= DISPATCH_LEVEL

Lihat juga