Partager via


structure NET_WAKE_SOURCE_LIST (netwakesourcelist.h)

La structure NET_WAKE_SOURCE_LIST représente une liste de sources wake-on-LAN (WoL) pour une carte réseau.

Syntaxe

typedef struct _NET_WAKE_SOURCE_LIST {
  ULONG Size;
  void  *Reserved[4];
} NET_WAKE_SOURCE_LIST;

Membres

Size

Taille de cette structure, en octets.

Reserved[4]

Réservé. Les pilotes clients ne doivent pas lire ou écrire directement dans cette valeur.

Remarques

Appelez NET_WAKE_SOURCE_LIST_INIT pour initialiser cette structure, puis appelez NetDeviceGetWakeSourceList pour obtenir la liste des sources de veille à partir de cet adaptateur net. Après avoir obtenu la liste, appelez NetWakeSourceListGetCount avec cette structure pour obtenir le nombre d’objets NETWAKESOURCE qui représentent les sources de mise en éveil, puis effectuez une boucle sur les objets et appelez NetWakeSourceListGetElement pour récupérer chacun d’eux. Une fois que vous avez obtenu un objet NETWAKESOURCE, appelez NetWakeSourceGetType pour obtenir le type de cette source de mise en éveil afin de pouvoir appeler la fonction appropriée pour obtenir les paramètres de la source de mise en éveil.

Le pilote client doit uniquement appeler des fonctions liées à la source de mise en éveil pendant une transition d’alimentation, généralement à partir de ses EVT_WDF_DEVICE_ARM_WAKE_FROM_SX, EVT_WDF_DEVICE_ARM_WAKE_FROM_S0ou EVT_NET_DEVICE_PREVIEW_WAKE_SOURCE 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 NETWAKESOURCE, consultez Configuration de la gestion de l’alimentation.

Exigences

Exigence Valeur
client minimum pris en charge Windows 10, version 2004
version minimale de UMDF 2.33
d’en-tête netwakesourcelist.h (include netadaptercx.h)

Voir aussi

Configuration des de gestion de l’alimentation

NET_WAKE_SOURCE_LIST_INIT

NetDeviceGetWakeSourceList

NetWakeSourceListGetCount

NetWakeSourceListGetElement

NetWakeSourceGetType