NetPowerOffloadListGetElement, fonction (netpoweroffloadlist.h)
La fonction NetPowerOffloadListGetElement obtient un déchargement de protocole à faible alimentation à partir d’une liste de déchargements sur un adaptateur net.
Syntaxe
NETPOWEROFFLOAD NetPowerOffloadListGetElement(
[_In_] const NET_POWER_OFFLOAD_LIST *List,
[_In_] SIZE_T Index
);
Paramètres
[_In_] List
Pointeur vers une structure NET_POWER_OFFLOAD_LISTNET_POWER_OFFLOAD_LIST allouée par le pilote.
[_In_] Index
Index de base zéro dans la liste de l’objet NETPOWEROFFLOAD cible. Cette fonction doit être inférieure à la valeur retournée par NetPowerOffloadListGetCount.
Valeur de retour
Renvoie l’objet NETPOWEROFFLOAD, qui représente le déchargement du protocole à faible alimentation, à l’index spécifié dans la liste.
Remarques
Appelez NetPowerOffloadListGetCount pour obtenir le nombre de déchargements de protocole à faible alimentation avant d’appeler cette fonction.
Le pilote client doit uniquement appeler NetPowerOffloadListGetElement pendant une transition d’alimentation, généralement à partir de son EVT_WDF_DEVICE_ARM_WAKE_FROM_SX, EVT_WDF_DEVICE_ARM_WAKE_FROM_S0ou EVT_NET_DEVICE_PREVIEW_POWER_OFFLOAD fonction de rappel. Dans le cas contraire, l’appel génère une vérification de bogue système.
Pour obtenir un exemple de code d’utilisation d’objets NETPOWEROFFLOAD, consultez Configuration de la gestion de l’alimentation.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 10, version 2004 |
| plateforme cible | Universel |
| version minimale de UMDF | 2.33 |
| d’en-tête | netpoweroffloadlist.h (include netadaptercx.h) |
| IRQL | PASSIVE_LEVEL |
Voir aussi
Configuration des de gestion de l’alimentation