Fungsi NdisGeneratePartialCancelId (ndis.h)

  • Artikel

Fungsi NdisGeneratePartialCancelId mengembalikan nilai yang harus digunakan driver panggilan sebagai byte urutan tinggi dari ID pembatalan.

Sintaks

UCHAR NdisGeneratePartialCancelId();

Mengembalikan nilai

NdisGeneratePartialCancelId mengembalikan nilai yang digunakan driver panggilan sebagai byte urutan tinggi dari ID pembatalan.

Keterangan

Sebelum menandai kirim struktur NET_BUFFER_LIST dengan ID pembatalan dengan memanggil NDIS_SET_NET_BUFFER_LIST_CANCEL_ID makro, driver harus memanggil NdisGeneratePartialCancelId satu atau beberapa kali. NdisGeneratePartialCancelId mengembalikan nilai yang dapat digunakan driver panggilan sebagai byte urutan tinggi dari ID pembatalan. Mengawali ID pembatalan dengan nilai yang dikembalikan oleh NdisGeneratePartialCancelId memastikan bahwa ID pembatalan tidak akan menjadi duplikat ID pembatalan yang ditetapkan oleh driver lain di komputer lokal.

Biasanya, driver yang terlalu berlebihan memanggil NdisGeneratePartialCancelId satu atau beberapa kali selama urutan inisialisasinya dan menyimpan nilai atau nilai yang dikembalikan untuk digunakan nanti. Driver protokol, misalnya, dapat memanggil NdisGeneratePartialCancelId sekali untuk setiap klien (seperti DHCP atau ARC) yang didukungnya. Driver protokol dapat memanggil Fungsi NdisCancelSendNetBufferLists nanti untuk membatalkan permintaan pengiriman. Dalam hal ini, NDIS memanggil fungsi batal kirim (misalnya, MiniportCancelSend) dari driver yang mendasar.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Didukung untuk driver NDIS 6.0 dan NDIS 5.1 (lihat NdisGeneratePartialCancelId (NDIS 5.1)) di Windows Vista. Didukung untuk driver NDIS 5.1 (lihat NdisGeneratePartialCancelId (NDIS 5.1)) di Windows XP.
Target Platform Desktop
Header ndis.h (termasuk Ndis.h)
Pustaka Ndis.lib
IRQL <= DISPATCH_LEVEL
Aturan kepatuhan DDI Irql_Miscellaneous_Function(ndis)

Lihat juga

MiniportCancelSend

NDIS_SET_NET_BUFFER_LIST_CANCEL_ID

NET_BUFFER_LIST

NdisCancelSendNetBufferLists