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 |