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

Weitere Informationen

NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS

NdisWdiIdleNotificationComplete