NetPowerOffloadListGetElement, fonction (netpoweroffloadlist.h)

  • Article

La fonction NetPowerOffloadListGetElement obtient un déchargement de protocole à faible consommation d’énergie à partir d’une liste de déchargements vers une carte réseau.

Syntaxe

NETPOWEROFFLOAD NetPowerOffloadListGetElement(
  [_In_] const NET_POWER_OFFLOAD_LIST *List,
  [_In_] SIZE_T                       Index
);

Paramètres

[_In_] List

Pointeur vers une structure de NET_POWER_OFFLOAD_LIST allouée et initialisée par le pilote.

[_In_] Index

Index de base zéro dans la liste pour l’objet NETPOWEROFFLOAD cible. Cette fonction doit être inférieure à la valeur retournée par NetPowerOffloadListGetCount.

Valeur retournée

Renvoie l’objet NETPOWEROFFLOAD, qui représente le déchargement du protocole de faible puissance, à l’index spécifié dans la liste.

Remarques

Appelez NetPowerOffloadListGetCount pour obtenir le nombre de déchargements de protocole à faible consommation d’énergie avant d’appeler cette fonction.

Le pilote client doit uniquement appeler NetPowerOffloadListGetElement 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.

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

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10, version 2004
Plateforme cible Universal
En-tête netpoweroffloadlist.h (inclure netadaptercx.h)
IRQL PASSIVE_LEVEL

Voir aussi

Configuration de la gestion de l’alimentation

NET_POWER_OFFLOAD_LIST

NetPowerOffloadListGetCount