WIFI_POWER_OFFLOAD_LIST structure (wificxpoweroffloadlist.h)

Article
03/01/2024

La structure WIFI_POWER_OFFLOAD_LIST représente une liste de déchargements de protocole à faible consommation d’alimentation vers un adaptateur réseau WiFiCx.

Syntaxe

typedef struct _WIFI_POWER_OFFLOAD_LIST {
  ULONG Size;
  void  *Reserved[4];
} WIFI_POWER_OFFLOAD_LIST;

Membres

Size

Taille de cette structure, en octets.

Reserved[4]

Réservé. Les pilotes clients ne doivent pas lire ou écrire directement cette valeur.

Remarques

Appelez WIFI_POWER_OFFLOAD_LIST_INIT pour initialiser cette structure, puis appelez WifiDeviceGetPowerOffloadList pour obtenir la liste des déchargements à faible puissance sur cet adaptateur réseau WiFiCx. Une fois la liste obtenue, appelez WifiPowerOffloadListGetCount avec cette structure pour obtenir le nombre d’objets WIFIPOWEROFFLOAD qui représentent les déchargements, puis effectuez une boucle sur les objets et appelez WifiPowerOffloadListGetElement pour les récupérer. Une fois que vous avez obtenu un objet WIFIPOWEROFFLOAD, appelez WifiPowerOffloadGetType pour obtenir le type de ce déchargement afin de pouvoir appeler la fonction appropriée pour obtenir les paramètres du déchargement.

Le pilote client doit uniquement appeler les fonctions liées au déchargement de l’alimentation 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 d’erreur système.