Fungsi NdisMIdleNotificationConfirm (ndis.h)

Artikel
03/08/2023

Driver Miniport memanggil NdisMIdleNotificationConfirm untuk memberi tahu NDIS bahwa adaptor jaringan diam dapat dengan aman ditangguhkan dan ditransisikan ke status daya rendah.

Driver Miniport memanggil fungsi ini selama operasi penangguhan selektif NDIS. NDIS memulai operasi ketika memanggil fungsi handler MiniportIdleNotification driver.

Sintaks

void NdisMIdleNotificationConfirm(
  [in] NDIS_HANDLE             MiniportAdapterHandle,
  [in] NDIS_DEVICE_POWER_STATE IdlePowerState
);

Parameter

[in] MiniportAdapterHandle

Adaptor jaringan menangani bahwa NDIS diteruskan ke parameter MiniportAdapterHandle dari MiniportInitializeEx.

[in] IdlePowerState

Nilai enumerasi NDIS_DEVICE_POWER_STATE yang menentukan status daya terendah yang didukung adaptor jaringan untuk transisi status daya rendah.

Catatan Untuk adaptor jaringan USB, parameter ini harus NdisDeviceStateD2.

Nilai kembali

Tidak ada

Keterangan

Driver Miniport memanggil NdisMIdleNotificationConfirm setelah NDIS memanggil fungsi MiniportIdleNotification driver. Dengan memanggil NdisMIdleNotificationConfirm, driver memberi tahu NDIS bahwa operasi penangguhan dapat dimulai dan adaptor jaringan dapat ditransisikan ke status daya rendah. Dalam panggilan ini, driver miniport mengatur parameter IdlePowerState ke status daya terendah yang dapat ditransisikan perangkat.

Sebelum driver miniport memanggil NdisMIdleNotificationConfirm, driver miniport harus mengeluarkan paket permintaan I/O khusus bus (IRP) yang mungkin diperlukan untuk menangguhkan adaptor jaringan secara selektif.

Misalnya, ketika NDIS memanggil fungsi MiniportIdleNotification , driver miniport USB mengeluarkan paket permintaan I/O khusus bus (IRP) untuk permintaan DIAM USB (IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION) ke driver bus USB. Ketika driver bus USB mengonfirmasi bahwa adaptor jaringan dapat beralih ke status daya rendah, ia memanggil rutinitas panggilan balik yang terkait dengan IRP. Dalam konteks rutinitas panggilan balik, driver miniport USB memanggil NdisMIdleNotificationConfirm. Untuk informasi selengkapnya, lihat Menerapkan Rutinitas Panggilan Balik IRP Permintaan Menganggur USB.

Catatan Driver miniport tidak boleh memanggil NdisMIdleNotificationConfirm untuk pemberitahuan menganggur yang sebelumnya selesai. Driver miniport menyelesaikan pemberitahuan menganggur dengan memanggil NdisMIdleNotificationComplete.

Untuk informasi selengkapnya tentang cara menangani pemberitahuan diam yang ditangguhkan selektif NDIS, lihat Menangani Pemberitahuan Diam Tangguhkan Selektif NDIS.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Didukung di NDIS 6.30 dan yang lebih baru.
Target Platform	Universal
Header	ndis.h (termasuk Ndis.h)
Pustaka	Ndis.lib
IRQL	PASSIVE_LEVEL

Lihat juga

IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION

MiniportIdleNotification

NdisMIdleNotificationComplete

Share via