MINIPORT_CANCEL_IDLE_NOTIFICATION Rückruffunktion (ndis.h)

Artikel
02/07/2025

NDIS ruft die MiniportCancelIdleNotification Handlerfunktion auf, um den Miniporttreiber zu benachrichtigen, dass NDIS die Aktivität auf dem angehaltenen Netzwerkadapter erkannt hat. Aus diesem Gründen bricht NDIS die Leerlaufbenachrichtigung ab, sodass der Netzwerkadapter in einen Vollstromzustand umgestellt werden kann.

Syntax

MINIPORT_CANCEL_IDLE_NOTIFICATION MiniportCancelIdleNotification;

void MiniportCancelIdleNotification(
  [in] NDIS_HANDLE MiniportAdapterContext
)
{...}

Parameter

[in] MiniportAdapterContext

Ein Handle zu einem Kontextbereich, den der Miniporttreiber in seiner MiniportInitializeEx--Funktion zugewiesen hat. Der Miniporttreiber verwendet diesen Kontextbereich, um Zustandsinformationen für einen Netzwerkadapter beizubehalten.

Rückgabewert

Nichts

Bemerkungen

Die MiniportCancelIdleNotification Handlerfunktion ist für Miniporttreiber erforderlich, die die selektive NDIS-Anhalteschnittstelle unterstützen. Weitere Informationen dazu, wie der Treiber seine selektiven Anhaltehandlerfunktionen registriert, finden Sie unter Registrieren von NDIS-Funktionen für selektive Anhaltehandlerfunktionen.

NDIS ruft die MiniportIdleNotification Handlerfunktion des Miniporttreibers auf, um einen selektiven NDIS-Anhaltevorgang auf einem Leerlaufnetzwerkadapter zu starten. Nachdem der Netzwerkadapter angehalten und in einen Energiesparzustand umgestellt wurde, kann NDIS die ausstehende Leerlaufbenachrichtigung abbrechen, wenn eine der folgenden Bedingungen zutrifft:

Ein Überlaufprotokoll oder Filtertreiber gibt entweder eine Sendepaketanforderung oder eine OID-Anforderung an den Miniporttreiber aus.
Der zugrunde liegende Adapter signalisiert ein Wake-up-Ereignis, z. B. das Empfangen eines Pakets, das einem Wake-on-LAN (WOL)-Muster entspricht, oder erkennt eine Änderung des Medienverbindungsstatus.

NDIS bricht die Leerlaufbenachrichtigung ab, indem MiniportCancelIdleNotificationaufgerufen wird. Wenn diese Handlerfunktion aufgerufen wird, bricht der Miniporttreiber zunächst alle busspezifischen E/A-Anforderungspakete (IRPs) ab, die er zuvor für die Leerlaufbenachrichtigung ausgestellt hat. Schließlich ruft der Miniporttreiber NdisMIdleNotificationComplete- auf, um die Leerlaufbenachrichtigung abzuschließen.

Weitere Informationen dazu, wie NDIS die Leerlaufbenachrichtigung abbricht, finden Sie unter Abbrechen der NDIS-Benachrichtigung für das selektive Anhalten des Leerlaufs.

Richtlinien zum Implementieren der MiniportCancelIdleNotification Handlerfunktion und IRP-Abschlussroutinen finden Sie unter Implementieren einer MiniportCancelIdleNotification-Handlerfunktion.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Unterstützt in NDIS 6.30 und höher.
Zielplattform-	Fenster
Header-	ndis.h (include Ndis.h)
IRQL-	PASSIVE_LEVEL

Siehe auch

IoCancelIrp-

MiniportIdleNotification

NdisMIdleNotificationComplete

Freigeben über