MINIPORT_WDI_IDLE_NOTIFICATION - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// dot11wdi.h
MINIPORT_WDI_IDLE_NOTIFICATION MiniportWdiIdleNotification;
NDIS_STATUS MiniportWdiIdleNotification(
[in] NDIS_HANDLE MiniportAdapterContext,
[in] BOOLEAN ForceIdle
)
{...}
View the official Windows Driver Kit DDI reference// dot11wificxintf.h
MINIPORT_WDI_IDLE_NOTIFICATION MiniportWdiIdleNotification;
NDIS_STATUS MiniportWdiIdleNotification(
NDIS_HANDLE MiniportAdapterContext,
BOOLEAN ForceIdle
)
{...}
View the official Windows Driver Kit DDI referenceNo description available.
[!IMPORTANT] This topic is part of the WDI driver model released in Windows 10. The WDI driver model is in maintenance mode and will only receive high priority fixes. WiFiCx is the Wi-Fi driver model released in Windows 11. We recommend that you use WiFiCx to take advantage of the latest features.
NDIS calls the MiniportWdiIdleNotification handler function to start the NDIS selective suspend operation on an idle network adapter. Through this operation, the network adapter is suspended and transitioned to a low-power state.
This is a WDI miniport handler inside NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS.
[!Note] You must declare the function by using the MINIPORT_WDI_IDLE_NOTIFICATION type. For more information, see the following Examples section.
MiniportAdapterContext [in]The handle to the context area that the miniport driver allocated.
ForceIdle [in]A BOOLEAN value that, when set to TRUE, specifies that the miniport driver must not veto the idle notification and must continue with the low-power state transition.
For more information about the ForceIdle parameter, see the Remarks section.
MiniportWdiIdleNotification can return any of the following return values.
| Return code | Description |
|---|---|
| NDIS_STATUS_PENDING | The miniport driver successfully handled the idle notification. The notification is left in a pending state until the miniport driver calls NdisWdiIdleNotificationComplete. Note: The miniport driver must not return NDIS_STATUS_SUCCESS from MiniportWdiIdleNotification. |
| NDIS_STATUS_BUSY | The miniport driver vetoed the idle notification because the network adapter is still being used. Note: MiniportWdiIdleNotification must not return this status code if the _ForceIdle_ parameter is set to TRUE. |
| NDIS_STATUS_FAILURE | The miniport driver could not issue a bus-specific IRP successfully. |
NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS
NdisWdiIdleNotificationComplete
[!IMPORTANT] This topic is part of the WiFiCx driver model. WiFiCx is the Wi-Fi driver model released in Windows 11. We recommend that you use WiFiCx to take advantage of the latest features. The previous Wi-Fi driver model WDI is in maintenance mode and will only receive high priority fixes.
[!WARNING] Some information in this topic relates to prereleased product, which may be substantially modified before it is commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
This function is reserved for system use and should not be called in your code.
MiniportAdapterContextReserved.
ForceIdleReserved.