Share via

Fungsi NdisDeregisterProtocol (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.

NdisDeregisterProtocol merilis sumber daya yang dialokasikan ketika driver yang disebut NdisRegisterProtocol.

Sintaks

void NdisDeregisterProtocol(
  [out] PNDIS_STATUS Status,
  [in]  NDIS_HANDLE  NdisProtocolHandle
);

Parameter

[out] Status

Penunjuk ke variabel yang disediakan penelepon yang diatur ke NDIS_STATUS_SUCCESS saat dikembalikan dari fungsi ini.

[in] NdisProtocolHandle

Menentukan handel yang dikembalikan oleh NdisRegisterProtocol saat driver diinisialisasi.

Menampilkan nilai

Tidak ada

Keterangan

Driver protokol terdaftar memanggil NdisDeregisterProtocol dalam salah satu keadaan berikut:

  • Driver yang sudah disebut NdisRegisterProtocol berhasil tetapi tidak dapat mengikat driver NDIS yang mendasar di komputer.

  • Driver sedang dibongkar. Artinya, rutinitas Bongkar yang disiapkan di objek drivernya selama inisialisasi telah dipanggil atau fungsi ProtocolUnbindAdapter telah dipanggil untuk melepaskan pengikatan terakhir driver yang tersisa.

    Untuk informasi selengkapnya tentang rutinitas Bongkar muat dan rutinitas driver mode kernel standar lainnya, lihat Komponen Driver Mode Kernel.

  • Sistem sedang dimatikan. Karena driver, yang merupakan protokol tingkat tertinggi, yang disebut IoRegisterShutdownNotification ketika diinisialisasi, rutinitas Shutdown-nya telah dipanggil.

    Lihat IoRegisterShutdownNotification untuk informasi selengkapnya.

Jika protokol memiliki pengikatan terbuka, panggilannya ke NdisDeregisterProtocol menyebabkan NDIS memanggil fungsi ProtocolUnbindAdapter protokol sekali untuk setiap pengikatan terbuka. ProtocolUnbindAdapter memanggil NdisCloseAdapter untuk menutup pengikatan.

Ketika outstanding terbuka, jika ada, telah ditutup, NdisDeregisterProtocol merilis semua filter yang telah disiapkan pemanggilnya dan membebaskan NDIS memori yang dialokasikan untuk melacak pengikatan dan filter untuk driver protokol.

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