MINIPORT_CANCEL_IDLE_NOTIFICATION fonction de rappel (ndis.h)

Article
02/07/2025

NDIS appelle la fonction de gestionnaire MiniportCancelIdleNotification pour avertir le pilote miniport que NDIS a détecté l’activité sur la carte réseau suspendue. En raison de cela, NDIS annule la notification inactive afin que la carte réseau puisse être transférée vers un état d’alimentation complète.

Syntaxe

MINIPORT_CANCEL_IDLE_NOTIFICATION MiniportCancelIdleNotification;

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

Paramètres

[in] MiniportAdapterContext

Handle vers une zone de contexte allouée par le pilote miniport dans sa fonction MiniportInitializeEx. Le pilote miniport utilise cette zone de contexte pour conserver les informations d’état d’une carte réseau.

Valeur de retour

Aucun

Remarques

La fonction de gestionnaire MiniportCancelIdleNotification est requise pour les pilotes miniports qui prennent en charge l’interface de suspension sélective NDIS. Pour plus d’informations sur la façon dont le pilote inscrit ses fonctions de gestionnaire d’interruption sélective, consultez Inscription des fonctions de gestionnaire de suspension sélective NDIS.

NDIS appelle le miniport driver MiniportIdleNotification fonction de gestionnaire pour démarrer une opération de suspension sélective NDIS sur une carte réseau inactive. Une fois la carte réseau suspendue et transférée vers un état à faible alimentation, NDIS peut annuler la notification d’inactivité en attente si l’une des conditions suivantes est remplie :

Un protocole ou un pilote de filtre excessive émet une demande de paquet d’envoi ou une requête OID au pilote miniport.
L’adaptateur sous-jacent signale un événement de mise en éveil, tel que la réception d’un paquet qui correspond à un modèle WOL (Wake-on-LAN) ou la détection d’une modification de son état de connexion multimédia.

NDIS annule la notification inactive en appelant MiniportCancelIdleNotification. Lorsque cette fonction de gestionnaire est appelée, le pilote miniport annule d’abord les paquets de demande d’E/S spécifiques au bus qu’il a émis précédemment pour la notification inactive. Enfin, le pilote miniport appelle NdisMIdleNotificationComplete pour terminer la notification inactive.

Pour plus d’informations sur la façon dont NDIS annule la notification inactive, consultez Annuler la notification d’inactivité de suspension sélective NDIS.

Pour obtenir des instructions sur l’implémentation des routines de saisie semi-automatique MiniportCancelIdleNotification fonction de gestionnaire et DRP, consultez Implémentation d’une fonction de gestionnaire MiniportCancelIdleNotification.

Exigences

Exigence	Valeur
client minimum pris en charge	Prise en charge dans NDIS 6.30 et versions ultérieures.
plateforme cible	Windows
d’en-tête	ndis.h (include Ndis.h)
IRQL	PASSIVE_LEVEL

Voir aussi

IoCancelIrp

MiniportIdleNotification

NdisMIdleNotificationComplete

Partager via