NET_POWER_OFFLOAD_LIST structure (netpoweroffloadlist.h)

Article
02/29/2024

La structure NET_POWER_OFFLOAD_LIST représente une liste de déchargements de protocole de faible puissance vers un adaptateur réseau.

Syntaxe

typedef struct _NET_POWER_OFFLOAD_LIST {
  ULONG Size;
  void  *Reserved[4];
} NET_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 NET_POWER_OFFLOAD_LIST_INIT pour initialiser cette structure, puis appelez NetDeviceGetPowerOffloadList pour obtenir la liste des déchargements à faible alimentation sur cet adaptateur réseau. Une fois la liste obtenue, appelez NetPowerOffloadListGetCount avec cette structure pour obtenir le nombre d’objets NETPOWEROFFLOAD qui représentent les déchargements, puis effectuez une boucle sur les objets et appelez NetPowerOffloadListGetElement pour les récupérer. Une fois que vous avez obtenu un objet NETPOWEROFFLOAD, appelez NetPowerOffloadGetType 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.

Pour obtenir un exemple de code sur l’utilisation d’objets NETPOWEROFFLOAD, consultez Configuration de la gestion de l’alimentation.