NdisMIdleNotificationComplete 函数 (ndis.h)

微型端口驱动程序调用 NdisMIdleNotificationComplete 以完成 NDIS 选择性挂起操作的挂起空闲通知。 NDIS 在调用驱动程序的 MiniportIdleNotification 处理程序函数时开始操作。

语法

void NdisMIdleNotificationComplete(
  [in] NDIS_HANDLE MiniportAdapterHandle
);

参数

[in] MiniportAdapterHandle

NDIS 传递给 MiniportInitializeExMiniportAdapterHandle 参数的网络适配器句柄。

返回值

备注

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 选择性挂起空闲通知

注意 微型端口驱动程序不得为以前完成的空闲通知调用 NdisMIdleNotificationConfirm
 

要求

要求
最低受支持的客户端 在 NDIS 6.30 及更高版本中受支持。
目标平台 通用
标头 ndis.h (包括 Ndis.h)
Library Ndis.lib
IRQL <= DISPATCH_LEVEL

另请参阅

IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION

MiniportCancelIdleNotification

MiniportIdleNotification

NdisMIdleNotificationConfirm