MINIPORT_CANCEL_IDLE_NOTIFICATION fonction de rappel (ndis.h)

Article
08/07/2023

NDIS appelle la fonction de gestionnaire MiniportCancelIdleNotification pour informer le pilote miniport que NDIS a détecté une activité sur la carte réseau suspendue. Pour cette raison, NDIS annule la notification d’inactivité afin que la carte réseau puisse être transitionnée vers un état de pleine alimentation.

Syntaxe

MINIPORT_CANCEL_IDLE_NOTIFICATION MiniportCancelIdleNotification;

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

Paramètres

[in] MiniportAdapterContext

Handle à une zone de contexte que le pilote miniport a allouée 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

None

Remarques

La fonction de gestionnaire MiniportCancelIdleNotification est requise pour les pilotes miniport 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 de suspension sélective, consultez Inscription des fonctions de gestionnaire de suspension sélective NDIS.

NDIS appelle la fonction de gestionnaire MiniportIdleNotification du pilote miniport 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 passée à un état de faible consommation d’énergie, NDIS peut annuler la notification d’inactivité en attente si l’une des conditions suivantes est remplie :

Un protocole ou un pilote de filtre sur-ment émet une demande d’envoi de paquets ou une demande 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 dans son status de connexion multimédia.

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

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

Pour obtenir des instructions sur l’implémentation de la fonction de gestionnaire MiniportCancelIdleNotification et des routines d’achèvement IRP, consultez Implémentation d’une fonction de gestionnaire MiniportCancelIdleNotification.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Pris en charge dans NDIS 6.30 et versions ultérieures.
Plateforme cible	Windows
En-tête	ndis.h (inclure Ndis.h)
IRQL	PASSIVE_LEVEL

Voir aussi

IoCancelIrp

MiniportIdleNotification

NdisMIdleNotificationComplete

Partager via