MINIPORT_WDI_IDLE_NOTIFICATION fonction de rappel (dot11wdi.h)
Important
Cette rubrique fait partie du modèle de pilote WDI publié dans Windows 10. Le modèle de pilote WDI est en mode maintenance et ne reçoit que des correctifs de priorité élevée. WiFiCx est le modèle de pilote Wi-Fi publié dans Windows 11. Nous vous recommandons d’utiliser WiFiCx pour tirer parti des dernières fonctionnalités.
NDIS appelle la fonction de gestionnaire MiniportWdiIdleNotification pour démarrer l’opération de suspension sélective NDIS sur une carte réseau inactive. Grâce à cette opération, la carte réseau est suspendue et passée à un état de faible consommation.
Il s’agit d’un gestionnaire de miniport WDI à l’intérieur de NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS.
Notes
Vous devez déclarer la fonction à l’aide du type MINIPORT_WDI_IDLE_NOTIFICATION . Pour plus d’informations, consultez la section Exemples suivante.
Syntaxe
MINIPORT_WDI_IDLE_NOTIFICATION MiniportWdiIdleNotification;
NDIS_STATUS MiniportWdiIdleNotification(
[in] NDIS_HANDLE MiniportAdapterContext,
[in] BOOLEAN ForceIdle
)
{...}
Paramètres
[in] MiniportAdapterContext
Handle à la zone de contexte allouée par le pilote miniport.
[in] ForceIdle
Valeur BOOLEAN qui, lorsqu’elle est définie sur TRUE, spécifie que le pilote miniport ne doit pas opposer son veto à la notification d’inactivité et doit poursuivre la transition de l’état de faible consommation.
Pour plus d’informations sur le paramètre ForceIdle, consultez la section Remarques.
Valeur retournée
MiniportWdiIdleNotification peut retourner l’une des valeurs de retour suivantes.
| Code de retour | Description |
|---|---|
| NDIS_STATUS_PENDING | Le pilote miniport a correctement géré la notification d’inactivité. La notification reste en attente jusqu’à ce que le pilote miniport appelle NdisWdiIdleNotificationComplete. Note: Le pilote miniport ne doit pas retourner NDIS_STATUS_SUCCESS à partir de MiniportWdiIdleNotification. |
| NDIS_STATUS_BUSY | Le pilote miniport a opposé son veto à la notification d’inactivité, car la carte réseau est toujours utilisée. Remarque :MiniportWdiIdleNotification ne doit pas renvoyer ce code status si le paramètre ForceIdle a la valeur TRUE. |
| NDIS_STATUS_FAILURE | Le pilote miniport n’a pas pu émettre une IRP spécifique au bus avec succès. |
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 10 |
| Serveur minimal pris en charge | Windows Server 2016 |
| Plateforme cible | Windows |
| En-tête | dot11wdi.h |