Fonction WifiPowerOffloadListGetElement (wificxpoweroffloadlist.h)
La fonction WifiPowerOffloadListGetElement obtient un déchargement de protocole à faible consommation d’énergie à partir d’une liste de déchargements vers un adaptateur réseau WiFiCx.
Syntaxe
WIFIPOWEROFFLOAD WifiPowerOffloadListGetElement(
const WIFI_POWER_OFFLOAD_LIST *List,
SIZE_T Index
);
Paramètres
List
[In] Pointeur vers une structure de WIFI_POWER_OFFLOAD_LIST allouée et initialisée par le pilote.
Index
[In] Index de base zéro dans la liste pour l’objet WIFIPOWEROFFLOAD cible. Cette fonction doit être inférieure à la valeur retournée par WifiPowerOffloadListGetCount.
Valeur retournée
Renvoie l’objet WIFIPOWEROFFLOAD, qui représente le déchargement du protocole de faible puissance, à l’index spécifié dans la liste.
Remarques
Appelez WifiPowerOffloadListGetCount pour obtenir le nombre de déchargements de protocole à faible consommation d’énergie avant d’appeler cette fonction.
Le pilote client doit uniquement appeler WifiPowerOffloadListGetElement pendant une transition d’alimentation, généralement à partir de sa fonction de rappel EVT_WDF_DEVICE_ARM_WAKE_FROM_SX, EVT_WDF_DEVICE_ARM_WAKE_FROM_S0 ou EVT_NET_DEVICE_PREVIEW_POWER_OFFLOAD . Sinon, l’appel entraîne une vérification de bogue système.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 11 |
| Serveur minimal pris en charge | Windows Server 2022 |
| En-tête | wificxpoweroffloadlist.h |
| IRQL | PASSIVE_LEVEL |