MINIPORT_WDI_IDLE_NOTIFICATION回调函数 (dot11wdi.h)

  • 项目

重要

本主题是 Windows 10 中发布的 WDI 驱动程序模型的一部分。 WDI 驱动程序模型处于维护模式，仅会收到高优先级修补程序。 WiFiCx 是 Windows 11 中发布的 Wi-Fi 驱动程序模型。 建议使用 WiFiCx 来利用最新功能。

NDIS 调用 MiniportWdiIdleNotification 处理程序函数，以在空闲网络适配器上启动 NDIS 选择性挂起操作。 通过此操作，网络适配器将挂起并转换为低功耗状态。

这是 NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS内的 WDI 微型端口处理程序。

注意

必须使用 MINIPORT_WDI_IDLE_NOTIFICATION 类型声明函数。 有关详细信息，请参阅以下示例部分。

语法

MINIPORT_WDI_IDLE_NOTIFICATION MiniportWdiIdleNotification;

NDIS_STATUS MiniportWdiIdleNotification(
  [in] NDIS_HANDLE MiniportAdapterContext,
  [in] BOOLEAN ForceIdle
)
{...}

参数

[in] MiniportAdapterContext

微型端口驱动程序分配的上下文区域的句柄。

[in] ForceIdle

一个 BOOLEAN 值，当设置为 TRUE 时，指定微型端口驱动程序不得否决空闲通知，并且必须继续执行低功耗状态转换。

有关 ForceIdle 参数的详细信息，请参阅“备注”部分。

返回值

MiniportWdiIdleNotification 可以返回以下任何返回值。

返回代码 说明
NDIS_STATUS_PENDING 微型端口驱动程序已成功处理空闲通知。 通知将保持挂起状态，直到微型端口驱动程序调用 NdisWdiIdleNotificationComplete。 注意： 微型端口驱动程序不得从 MiniportWdiIdleNotification 返回NDIS_STATUS_SUCCESS。
NDIS_STATUS_BUSY 微型端口驱动程序已否决空闲通知，因为网络适配器仍在使用。 注意：如果 ForceIdle 参数设置为 TRUE，MiniportWdiIdleNotification 不得返回此状态代码。
NDIS_STATUS_FAILURE 微型端口驱动程序无法成功发出特定于总线的 IRP。

要求

要求 值
最低受支持的客户端 Windows 10
最低受支持的服务器 Windows Server 2016
目标平台 Windows
标头 dot11wdi.h

另请参阅

NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS

NdisWdiIdleNotificationComplete