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
布尔值，当设置为 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 |
| 目标平台 | 窗户 |
| 标头 | dot11wdi.h |