通过

NdisMIdleNotificationConfirm 函数 （ndis.h）

  • 项目

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

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

语法

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

参数

[in] MiniportAdapterHandle

传递给 MiniportInitializeEx的 MiniportAdapterHandle 参数的网络适配器句柄。

[in] IdlePowerState

一个 NDIS_DEVICE_POWER_STATE 枚举值，该值指定网络适配器支持低功率状态转换的最低电源状态。

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

返回值

没有

言论

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

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

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

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

要求

要求 价值
最低支持的客户端 NDIS 6.30 及更高版本中受支持。
目标平台 普遍
标头 ndis.h （包括 Ndis.h）
库 Ndis.lib
IRQL PASSIVE_LEVEL

另请参阅

IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION

MiniportIdleNotification

NdisMIdleNotificationComplete