NetPowerOffloadListGetElement, fonction (netpoweroffloadlist.h)
La fonction NetPowerOffloadListGetElement obtient un déchargement de protocole à faible consommation d’alimentation à partir d’une liste de déchargements vers un adaptateur 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 par le pilote et initialisée.
[_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
Retourne 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 de faible puissance 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 d’erreur système.
Pour obtenir un exemple de code sur l’utilisation d’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 |
| Version UMDF minimale | 2,33 |
| En-tête | netpoweroffloadlist.h (inclure netadaptercx.h) |
| IRQL | PASSIVE_LEVEL |