MINIPORT_CANCEL_IDLE_NOTIFICATION回调函数 (ndis.h)

NDIS 调用 MiniportCancelIdleNotification 处理程序函数,以通知微型端口驱动程序 NDIS 检测到挂起网络适配器上的活动。 因此,NDIS 会取消空闲通知,以便网络适配器可以转换为全电源状态。

语法

MINIPORT_CANCEL_IDLE_NOTIFICATION MiniportCancelIdleNotification;

void MiniportCancelIdleNotification(
  [in] NDIS_HANDLE MiniportAdapterContext
)
{...}

参数

[in] MiniportAdapterContext

微型端口驱动程序在其 MiniportInitializeEx 函数中分配的上下文区域的句柄。 微型端口驱动程序使用此上下文区域来维护网络适配器的状态信息。

返回值

备注

支持 NDIS 选择性挂起接口的微型端口驱动程序需要 MiniportCancelIdleNotification 处理程序函数。 有关驱动程序如何注册其选择性挂起处理程序函数的详细信息,请参阅 注册 NDIS 选择性挂起处理程序函数

NDIS 调用微型端口驱动程序的 MiniportIdleNotification 处理程序函数,以在空闲网络适配器上启动 NDIS 选择性挂起操作。 在网络适配器暂停并转换为低功率状态后,如果满足以下任一条件,NDIS 可以取消未完成的空闲通知:

  • 过度分配的协议或筛选器驱动程序会向微型端口驱动程序发出发送数据包请求或 OID 请求。
  • 基础适配器发出唤醒事件信号,例如接收与 LAN 唤醒 (WOL) 模式匹配的数据包,或检测其媒体连接状态的变化。
NDIS 通过调用 MiniportCancelIdleNotification 取消空闲通知。 调用此处理程序函数时,微型端口驱动程序首先取消任何特定于总线的 I/O 请求数据包, (IRP) 以前可能已针对空闲通知颁发的。 最后,微型端口驱动程序调用 NdisMIdleNotificationComplete 以完成空闲通知。

有关 NDIS 如何取消空闲通知的详细信息,请参阅 “取消 NDIS 选择性挂起空闲通知”。

有关如何实现 MiniportCancelIdleNotification 处理程序函数和 IRP 完成例程的指南,请参阅 实现 MiniportCancelIdleNotification 处理程序函数

要求

   
最低受支持的客户端 在 NDIS 6.30 及更高版本中受支持。
目标平台 Windows
标头 ndis.h (包括 Ndis.h)
IRQL PASSIVE_LEVEL

另请参阅

IoCancelIrp

MiniportIdleNotification

NdisMIdleNotificationComplete