structure NET_WAKE_SOURCE_LIST (netwakesourcelist.h)

Article
02/26/2024

La structure NET_WAKE_SOURCE_LIST représente une liste de sources de 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 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 cette carte réseau. Une fois la liste obtenue, appelez NetWakeSourceListGetCount avec cette structure pour obtenir le nombre d’objets NETWAKESOURCE qui représentent les sources de veille, puis effectuez une boucle sur les objets et appelez NetWakeSourceListGetElement pour les récupérer. Une fois que vous avez obtenu un objet NETWAKESOURCE, appelez NetWakeSourceGetType pour obtenir le type de cette source de veille afin de pouvoir appeler la fonction appropriée pour obtenir les paramètres de la source de veille.

Le pilote client doit uniquement appeler les fonctions liées à la source de veille 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_WAKE_SOURCE . Sinon, l’appel entraîne une vérification de bogue système.

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