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 transférée vers un état de faible alimentation.
Il s’agit d’un gestionnaire miniport WDI à l’intérieur NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS.
Note
Vous devez déclarer la fonction à l’aide du type MINIPORT_WDI_IDLE_NOTIFICATION. Pour plus d’informations, consultez la section Exemples suivants.
Syntaxe
MINIPORT_WDI_IDLE_NOTIFICATION MiniportWdiIdleNotification;
NDIS_STATUS MiniportWdiIdleNotification(
[in] NDIS_HANDLE MiniportAdapterContext,
[in] BOOLEAN ForceIdle
)
{...}
Paramètres
[in] MiniportAdapterContext
Handle vers 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 de veto à la notification d’inactivité et doit continuer avec la transition d’état à faible alimentation.
Pour plus d’informations sur le paramètre ForceIdle, consultez la section Notes.
Valeur de retour
MiniportWdiIdleNotification peut retourner l’une des valeurs de retour suivantes.
| Retourner le code | Description |
|---|---|
| NDIS_STATUS_PENDING | Le pilote miniport a réussi à gérer la notification inactive. La notification est laissée dans un état en attente jusqu’à ce que le pilote miniport appelle NdisWdiIdleNotificationComplete. Remarque : Le pilote miniport ne doit pas retourner NDIS_STATUS_SUCCESS de MiniportWdiIdleNotification. |
| NDIS_STATUS_BUSY | Le pilote miniport a annulé la notification d’inactivité, car la carte réseau est toujours utilisée. Remarque :MiniportWdiIdleNotification ne doit pas retourner ce code d’état si le paramètre ForceIdle a la valeur TRUE. |
| NDIS_STATUS_FAILURE | Le pilote miniport n’a pas pu émettre un IRP spécifique au bus avec succès. |
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 10 |
| serveur minimum pris en charge | Windows Server 2016 |
| plateforme cible | Windows |
| d’en-tête | dot11wdi.h |