NdisMIdleNotificationConfirm, fonction (ndis.h)

Article
02/07/2025

Les pilotes miniport appellent NdisMIdleNotificationConfirm pour informer NDIS que la carte réseau inactive peut être suspendue et transférée en toute sécurité vers un état à faible alimentation.

Les pilotes miniport appellent cette fonction pendant une opération de suspension sélective NDIS. NDIS démarre l’opération lorsqu’elle 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

La carte réseau handle que NDIS a passée 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 bas pris en charge par la carte réseau pour une transition d’état à faible alimentation.

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

Valeur de retour

Aucun

Remarques

Les pilotes Miniport appellent NdisMIdleNotificationConfirm après que NDIS appelle 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 transférée vers un état à faible alimentation. Dans cet appel, le pilote miniport définit le paramètre IdlePowerState à l’état d’alimentation le plus bas vers lequel l’appareil peut passer.

Avant que le pilote miniport appelle NdisMIdleNotificationConfirm, il doit émettre tous les paquets de requêtes d’E/S spécifiques au bus (IRPs) 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êtes d’E/S spécifique au bus (IRP) 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 alimentation, elle 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 demande d’inactivité USB.

Remarque Un pilote miniport ne doit pas appeler NdisMIdleNotificationConfirm pour une notification inactive qui a été terminée précédemment. Le pilote miniport termine la notification inactive en appelant NdisMIdleNotificationComplete.

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

Exigences

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

Voir aussi

IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION

MiniportIdleNotification

NdisMIdleNotificationComplete

Partager via