Partager via


NetPowerOffloadListGetCount, fonction (netpoweroffloadlist.h)

La fonction NetPowerOffloadListGetCount obtient le nombre de déchargements de protocole à faible consommation d’énergie sur un adaptateur net.

Syntaxe

SIZE_T NetPowerOffloadListGetCount(
  [_In_] const NET_POWER_OFFLOAD_LIST *List
);

Paramètres

[_In_] List

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

Valeur retournée

Retourne le nombre de décharges à faible consommation d’alimentation dans cet adaptateur net.

Remarques

Appelez NET_POWER_OFFLOAD_LIST_INIT pour initialiser la structure NET_POWER_OFFLOAD_LIST , puis appelez NetDeviceGetPowerOffloadList pour récupérer la liste de déchargement du protocole de faible alimentation. Après avoir obtenu la liste, appelez cette fonction pour déterminer le nombre de déchargements de protocole à faible consommation d’énergie qu’il y a sur cette carte réseau.

Le pilote client doit uniquement appeler NetPowerOffloadListGetCount 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
Version UMDF minimale 2,33
En-tête netpoweroffloadlist.h (inclure netadaptercx.h)
IRQL PASSIVE_LEVEL

Voir aussi

Configuration de la gestion de l’alimentation

NET_POWER_OFFLOAD_LIST_INIT

NET_POWER_OFFLOAD_LIST

NetDeviceGetPowerOffloadList