NdisMIdleNotificationComplete 函数 (ndis.h)
微型端口驱动程序调用 NdisMIdleNotificationComplete 以完成 NDIS 选择性挂起操作的挂起空闲通知。 NDIS 在调用驱动程序的 MiniportIdleNotification 处理程序函数时开始操作。
语法
void NdisMIdleNotificationComplete(
[in] NDIS_HANDLE MiniportAdapterHandle
);
参数
[in] MiniportAdapterHandle
NDIS 传递给 MiniportInitializeEx 的 MiniportAdapterHandle 参数的网络适配器句柄。
返回值
无
备注
NDIS 调用微型端口驱动程序的 MiniportCancelIdleNotification 处理程序函数,以完成 NDIS 选择性挂起操作的挂起空闲通知。 微型端口驱动程序调用 NdisMIdleNotificationComplete 以通知 NDIS 网络适配器的空闲通知已完成。 然后,NDIS 将适配器转换为全功率状态,以完成选择性挂起操作。
在微型端口驱动程序调用 NdisMIdleNotificationComplete 之前,它必须取消任何特定于总线的 I/O 请求数据包, (IRP) 之前可能已针对空闲通知发出。
例如,当 NDIS 调用 MiniportIdleNotification 函数时,USB 微型端口驱动程序向 USB 总线驱动程序发出特定于总线的 USB 空闲请求 IRP (IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION) 。 当 NDIS 调用驱动程序的 MiniportCancelIdleNotification 函数时,驱动程序将取消 IRP。 当 USB 总线驱动程序调用与 IRP 关联的完成例程时,它会确认 IRP 已取消,并且设备可以恢复为全功率状态。 在完成例程的上下文中,微型端口驱动程序调用 NdisMIdleNotificationComplete。 有关详细信息,请参阅 实现 USB 空闲请求 IRP 完成例程。
有关微型端口驱动程序如何完成 NDIS 选择性挂起空闲通知的详细信息,请参阅 完成 NDIS 选择性挂起空闲通知。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 在 NDIS 6.30 及更高版本中受支持。 |
目标平台 | 通用 |
标头 | ndis.h (包括 Ndis.h) |
Library | Ndis.lib |
IRQL | <= DISPATCH_LEVEL |
另请参阅
IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION