MINIPORT_CANCEL_IDLE_NOTIFICATION Rückruffunktion (ndis.h)

Artikel
08/07/2023

NDIS ruft die MiniportCancelIdleNotification-Handlerfunktion auf, um den Miniporttreiber zu benachrichtigen, dass NDIS Aktivitäten auf dem angehaltenen Netzwerkadapter erkannt hat. Aus diesem Fall bricht NDIS die Benachrichtigung im Leerlauf ab, sodass der Netzwerkadapter in einen Vollstromzustand übergehen kann.

Syntax

MINIPORT_CANCEL_IDLE_NOTIFICATION MiniportCancelIdleNotification;

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

Parameter

[in] MiniportAdapterContext

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

Rückgabewert

Keine

Bemerkungen

Die MiniportCancelIdleNotification-Handlerfunktion ist für Miniporttreiber erforderlich, die die NDIS-Schnittstelle für das selektive Anhalten unterstützen. Weitere Informationen dazu, wie der Treiber seine Funktionen für selektives Anhalten registriert, finden Sie unter Registrieren von NDIS-Handlerfunktionen für selektives Anhalten.

NDIS ruft die MiniportIdleNotification-Handlerfunktion des Miniporttreibers auf, um einen selektiven NDIS-Anhaltevorgang für einen Netzwerkadapter im Leerlauf zu starten. Nachdem der Netzwerkadapter angehalten und in einen Energiesparzustand übergegangen wurde, kann NDIS die ausstehende Leerlaufbenachrichtigung abbrechen, wenn eine der folgenden Bedingungen zutrifft:

Ein übermäßiger Protokoll- oder Filtertreiber gibt entweder eine Anforderung zum Senden eines Pakets oder eine OID-Anforderung an den Miniporttreiber aus.
Der zugrunde liegende Adapter signalisiert ein Aktivierungsereignis, z. B. den Empfang eines Pakets, das einem WOL-Muster (Wake-on-LAN) entspricht, oder das Erkennen einer Änderung der Medienverbindung status.

NDIS bricht die Leerlaufbenachrichtigung ab, indem MiniportCancelIdleNotification aufgerufen wird. Wenn diese Handlerfunktion aufgerufen wird, bricht der Miniporttreiber zunächst alle busspezifischen E/A-Anforderungspakete (IRPs) ab, die er zuvor möglicherweise 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 zum selektiven Anhalten im Leerlauf.

Richtlinien zum Implementieren der MiniportCancelIdleNotification-Handlerfunktion und IRP-Vervollständigungsroutinen finden Sie unter Implementieren einer MiniportCancelIdleNotification-Handlerfunktion.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt in NDIS 6.30 und höher.
Zielplattform	Windows
Kopfzeile	ndis.h (include Ndis.h)
IRQL	PASSIVE_LEVEL

Weitere Informationen

IoCancelIrp

MiniportIdleNotification

NdisMIdleNotificationComplete

Freigeben über