NdisMIdleNotificationConfirm, fonction (ndis.h)

Article
02/26/2024

Les pilotes Miniport appellent NdisMIdleNotificationConfirm pour informer NDIS que la carte réseau inactive peut être suspendue en toute sécurité et passer à un état de faible consommation.

Les pilotes miniport appellent cette fonction pendant une opération de suspension sélective NDIS. NDIS commence l’opération quand il appelle la fonction de gestionnaire MiniportIdleNotification du pilote.

Syntaxe

void NdisMIdleNotificationConfirm(
  [in] NDIS_HANDLE             MiniportAdapterHandle,
  [in] NDIS_DEVICE_POWER_STATE IdlePowerState
);

Paramètres

[in] MiniportAdapterHandle

Handle de carte réseau que NDIS a transmis au paramètre MiniportAdapterHandle de MiniportInitializeEx.

[in] IdlePowerState

Valeur d’énumération NDIS_DEVICE_POWER_STATE qui spécifie l’état d’alimentation le plus faible pris en charge par la carte réseau pour une transition d’état de faible consommation.

Note Pour les cartes réseau USB, ce paramètre doit être NdisDeviceStateD2.

Valeur de retour

None

Remarques

Les pilotes Miniport appellent NdisMIdleNotificationConfirm après que NDIS a appelé la fonction MiniportIdleNotification du pilote. En appelant NdisMIdleNotificationConfirm, le pilote informe NDIS que l’opération de suspension peut démarrer et que la carte réseau peut être transitionnée vers un état de faible consommation. Dans cet appel, le pilote miniport définit le paramètre IdlePowerState sur l’état d’alimentation le plus faible vers lequel l’appareil peut effectuer la transition.

Avant que le pilote miniport appelle NdisMIdleNotificationConfirm, il doit émettre tous les paquets de demandes d’E/S (IRP) spécifiques au bus qui peuvent être nécessaires pour suspendre sélectivement la carte réseau.

Par exemple, lorsque NDIS appelle la fonction MiniportIdleNotification , le pilote miniport USB émet le paquet de requête d’E/S (IRP) spécifique au bus pour une demande d’inactivité USB (IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION) au pilote de bus USB. Lorsque le pilote de bus USB confirme que la carte réseau peut passer à un état de faible consommation d’alimentation, il appelle la routine de rappel associée à l’IRP. Dans le contexte de la routine de rappel, le pilote miniport USB appelle NdisMIdleNotificationConfirm. Pour plus d’informations, consultez Implémentation d’une routine de rappel IRP de requête inactive USB.

Note Un pilote miniport ne doit pas appeler NdisMIdleNotificationConfirm pour une notification d’inactivité précédemment terminée. Le pilote miniport termine la notification d’inactivité en appelant NdisMIdleNotificationComplete.

Pour plus d’informations sur la gestion des notifications d’inactivité de suspension sélective NDIS, consultez Gestion de la notification d’inactivité de suspension sélective NDIS.

Configuration requise

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

Voir aussi

IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION

MiniportIdleNotification

NdisMIdleNotificationComplete

Partager via