Share via

Fungsi NdisMRegisterUnloadHandler (ndis.h)

  • Artikel

Catatan NDIS 5. x telah ditolak 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.

Fungsi NdisMRegisterUnloadHandler mendaftarkan handler unload untuk driver.

Sintaks

void NdisMRegisterUnloadHandler(
  [in] NDIS_HANDLE    NdisWrapperHandle,
  [in] PDRIVER_UNLOAD UnloadHandler
);

Parameter

[in] NdisWrapperHandle

Menentukan handel yang dikembalikan oleh NdisMInitializeWrapper.

[in] UnloadHandler

Menentukan titik masuk untuk rutinitas pembongkaran driver. Rutinitas bongkar dinyatakan sebagai berikut:

VOID
(*PDRIVER_UNLOAD) (
    IN struct _DRIVER_OBJECT *DriverObject
    );

Nilai kembali

Tidak ada

Keterangan

Driver memanggil NdisMRegisterUnloadHandler dari fungsi DriverEntry setelah DriverEntry memanggil NdisMRegisterMiniport atau NdisIMRegisterLayeredMiniport. NdisMRegisterUnloadHandler mendaftarkan handler unload untuk driver.

Fungsionalitas handler bongkar adalah khusus driver. Misalnya, driver perantara harus mendaftarkan penangan bongkar yang memanggil NdisDeregisterProtocol untuk membatalkan pendaftaran bagian protokol driver perantara. Handler unload juga harus melakukan operasi pembersihan yang diperlukan, seperti membatalkan alokasi sumber daya yang digunakan oleh bagian protokol driver.

Driver miniport, seperti driver miniport penyeimbang beban, yang memantau lebih dari satu instans driver miniport harus mendaftarkan handler unload yang membersihkan informasi status dan membatalkan alokasi sumber daya setelah instans driver miniport yang dipantaunya dihentikan. Perhatikan bahwa handler unload berbeda dari fungsi MiniportHalt : handler unload memiliki cakupan yang lebih global, sedangkan cakupan fungsi MiniportHalt dibatasi untuk instans driver miniport tertentu.

  • Platform target: Universal
  • Versi: Tidak didukung untuk driver NDIS 6.0 di Windows Vista. Gunakan NdisMRegisterMiniportDriversebagai 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 PASSIVE_LEVEL

Lihat juga