MINIPORT_WDI_IDLE_NOTIFICATION Rückruffunktion (dot11wdi.h)
Wichtig
Dieses Thema ist Teil des WDI-Treibermodells, das in Windows 10 veröffentlicht wurde. Das WDI-Treibermodell befindet sich im Wartungsmodus und erhält nur Korrekturen mit hoher Priorität. WiFiCx ist das Wi-Fi Treibermodell, das in Windows 11 veröffentlicht wurde. Es wird empfohlen, wiFiCx zu verwenden, um die neuesten Features zu nutzen.
NDIS ruft die MiniportWdiIdleNotification-Handlerfunktion auf, um den selektiven NDIS-Vorgang für einen Netzwerkadapter im Leerlauf zu starten. Durch diesen Vorgang wird der Netzwerkadapter angehalten und in einen Energiesparzustand überstellt.
Dies ist ein WDI-Miniporthandler in NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS.
Hinweis
Sie müssen die Funktion mit dem MINIPORT_WDI_IDLE_NOTIFICATION-Typ deklarieren. Weitere Informationen finden Sie im folgenden Abschnitt Beispiele.
Syntax
MINIPORT_WDI_IDLE_NOTIFICATION MiniportWdiIdleNotification;
NDIS_STATUS MiniportWdiIdleNotification(
[in] NDIS_HANDLE MiniportAdapterContext,
[in] BOOLEAN ForceIdle
)
{...}
Parameter
[in] MiniportAdapterContext
Das Handle für den Kontextbereich, den der Miniporttreiber zugewiesen hat.
[in] ForceIdle
Ein BOOLEAN-Wert, der bei Festlegung auf TRUE angibt, dass der Miniporttreiber kein Veto gegen die Leerlaufbenachrichtigung einzulegen und mit dem Übergang zum Zustand mit geringer Leistung fortfahren muss.
Weitere Informationen zum ForceIdle-Parameter finden Sie im Abschnitt Hinweise.
Rückgabewert
MiniportWdiIdleNotification kann einen der folgenden Rückgabewerte zurückgeben.
| Rückgabecode | Beschreibung |
|---|---|
| NDIS_STATUS_PENDING | Der Miniporttreiber hat die Leerlaufbenachrichtigung erfolgreich verarbeitet. Die Benachrichtigung befindet sich in einem ausstehenden Zustand, bis der Miniporttreiber NdisWdiIdleNotificationComplete aufruft. Hinweis: Der Miniporttreiber darf NDIS_STATUS_SUCCESS von MiniportWdiIdleNotification nicht zurückgeben. |
| NDIS_STATUS_BUSY | Der Miniporttreiber hat gegen die Benachrichtigung im Leerlauf ein Veto eingeschoben, da der Netzwerkadapter weiterhin verwendet wird. Hinweis:MiniportWdiIdleNotification darf diesen status Code nicht zurückgeben, wenn der ForceIdle-Parameter auf TRUE festgelegt ist. |
| NDIS_STATUS_FAILURE | Der Miniporttreiber konnte keine busspezifische IRP erfolgreich ausstellen. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10 |
| Unterstützte Mindestversion (Server) | Windows Server 2016 |
| Zielplattform | Windows |
| Kopfzeile | dot11wdi.h |