Fonction WifiPowerOffloadListGetElement (wificxpoweroffloadlist.h)

  • Article

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

Voir aussi

WIFI_POWER_OFFLOAD_LIST

WifiPowerOffloadListGetCount