NdisMIdleNotificationConfirm 函数 (ndis.h)

微型端口驱动程序调用 NdisMIdleNotificationConfirm 以通知 NDIS 空闲的网络适配器可以安全地挂起并转换为低功耗状态。

微型端口驱动程序在 NDIS 选择性挂起操作期间调用此函数。 NDIS 在调用驱动程序的 MiniportIdleNotification 处理程序函数时开始操作。

语法

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

参数

[in] MiniportAdapterHandle

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

[in] IdlePowerState

一个 NDIS_DEVICE_POWER_STATE 枚举值,该值指定网络适配器支持用于低功耗状态转换的最低功率状态。

注意 对于 USB 网络适配器,此参数必须为 NdisDeviceStateD2
 

返回值

备注

微型端口驱动程序在 NDIS 调用驱动程序的 MiniportIdleNotification 函数后调用 NdisMIdleNotificationConfirm 通过调用 NdisMIdleNotificationConfirm,驱动程序通知 NDIS 暂停操作可以启动,并且网络适配器可以转换为低功耗状态。 在此调用中,微型端口驱动程序将 IdlePowerState 参数设置为设备可以转换到的最低功率状态。

在微型端口驱动程序调用 NdisMIdleNotificationConfirm 之前,它必须发出任何特定于总线的 I/O 请求数据包 (IRP) ,这些数据包可能是选择性地挂起网络适配器所必需的。

例如,当 NDIS 调用 MiniportIdleNotification 函数时,USB 微型端口驱动程序针对 USB 空闲请求发出特定于总线的 I/O 请求数据包 (IRP) , (IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION USB 总线 驱动程序) 。 当 USB 总线驱动程序确认网络适配器可以转换为低功耗状态时,它会调用与 IRP 关联的回调例程。 在回调例程的上下文中,USB 微型端口驱动程序调用 NdisMIdleNotificationConfirm。 有关详细信息,请参阅 实现 USB 空闲请求 IRP 回调例程

注意 微型端口驱动程序不得调用 NdisMIdleNotificationConfirm 以获取之前完成的空闲通知。 微型端口驱动程序通过调用 NdisMIdleNotificationComplete 完成空闲通知。
 
有关如何处理 NDIS 选择性挂起空闲通知的详细信息,请参阅 处理 NDIS 选择性挂起空闲通知

要求

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

另请参阅

IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION

MiniportIdleNotification

NdisMIdleNotificationComplete