Fungsi NdisIMNotifyPnPEvent (ndis.h)

Artikel
02/29/2024

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.

NdisIMNotifyPnPEvent menyebarluaskan pemberitahuan peristiwa Plug and Play atau Power Management ke driver yang terlalu berlebihan.

Sintaks

NDIS_STATUS NdisIMNotifyPnPEvent(
  [in] NDIS_HANDLE    MiniportHandle,
  [in] PNET_PNP_EVENT NetPnPEvent
);

Parameter

[in] MiniportHandle

Input handel ke MiniportInitialize. Handel ini mewakili driver miniport yang terpengaruh oleh peristiwa Plug and Play atau Power Management yang diteruskan ke fungsi ProtocolPnPEvent pemanggil.

[in] NetPnPEvent

Arahkan ke struktur NET_PNP_EVENT, yang menjelaskan peristiwa Plug and Play atau peristiwa Power Management yang ditunjukkan ke driver protokol.

Menampilkan nilai

NdisIMNotifyPnPEvent dapat mengembalikan salah satu hal berikut:

Menampilkan kode	Deskripsi
NDIS_STATUS_SUCCESS	Driver yang terlalu banyak berhasil disebarluaskan Plug and Play peristiwa berhasil.
NDIS_STATUS_FAILURE	Driver yang terlalu berlebihan gagal dalam peristiwa Plug and Play yang disebarkan.

Nilai yang dikembalikan hanya signifikan ketika peristiwa yang disebarkan adalah NetEventQueryPower atau NetEventQueryRemove. Untuk semua peristiwa lain yang disebarkan, nilai yang dikembalikan selalu NDIS_STATUS_SUCCESS.

Keterangan

Driver perantara NDIS memanggil NdisIMNotifyPnPEvent dalam konteks fungsi ProtocolPnPEvent driver untuk menyebarluaskan pemberitahuan peristiwa Plug and Play atau Power Management ke driver yang terlalu berlebihan.

Jika peristiwa yang disebarkan adalah NetEventQueryPower atau NetEventQueryRemove, driver perantara harus memeriksa nilai NDIS_STATUS yang dikembalikan oleh NdisIMNotifyPnPEvent. Jika status yang dikembalikan NDIS_STATUS_SUCCESS, driver perantara harus menangani peristiwa secara internal seperti biasa dan kemudian mengembalikan NDIS_STATUS_SUCCESS dari fungsi ProtocolPnPEvent-nya . Jika status yang dikembalikan NDIS_STATUS_FAILURE, driver perantara harus mengembalikan NDIS_STATUS_FAILURE dari ProtocolPnPEvent tanpa pemrosesan lebih lanjut.

Untuk semua peristiwa lain yang disebarkan, NdisIMNotifyPnPEvent selalu mengembalikan NDIS_STATUS_SUCCESS. Fungsi ProtocolPnPEvent driver menengah dalam kasus seperti itu harus menyebarluaskan NDIS_STATUS yang dikembalikan oleh NdisIMNotifyPnPEvent.

Bagaimana driver perantara memproses NetEventSetPower yang diterima oleh fungsi ProtocolPnPEvent-nya tergantung pada status daya perangkat yang ditentukan. Jika status daya perangkat yang ditentukan adalah NdisDeviceStateD0, driver perantara harus menangani peristiwa secara internal seperti biasa lalu memanggil NdisIMNotifyPnPEvent. Untuk status daya perangkat tertentu lainnya, driver perantara harus terlebih dahulu memanggil NdisIMNotifyPnPEvent lalu menangani peristiwa secara internal seperti biasa.

Driver perantara harus memanggil NdisIMNotifyPnPEvent untuk menyebarluaskan NetEventReconfigure atau NetEventBindList hanya jika NetEventReconfigure atau NetEventBindList ditunjukkan pada Protokol non-NULLBindingContext. Jika NetEventReconfigure atau NetEventBindList ditunjukkan pada PROTOKOL NULLBindingContext, driver perantara tidak boleh memanggil NdisIMNotifyPnPEvent untuk menyebarluaskan peristiwa.

Jika driver perantara menangani NetEventReconfigure atau NetEventBindList, driver perantara harus memvalidasi data apa pun yang terkait dengan peristiwa tersebut. (Untuk informasi selengkapnya tentang data tersebut, lihat NET_PNP_EVENT untuk Driver Protokol.)

Dukungan sistem untuk NdisIMNotifyPnPEvent tersedia di Windows XP dan versi yang lebih baru.

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

Share via