NetWakeSourceListGetElement, fonction (netwakesourcelist.h)
La fonction NetWakeSourceListGetElement obtient une source de veille à partir de la liste des sources de veille pour un adaptateur net.
Syntaxe
NETWAKESOURCE NetWakeSourceListGetElement(
[_In_] const NET_WAKE_SOURCE_LIST *List,
[_In_] SIZE_T Index
);
Paramètres
[_In_] List
Handle d’une structure de NET_WAKE_SOURCE_LIST allouée et initialisée par un pilote.
[_In_] Index
Index de base zéro dans la liste pour l’objet NETWAKESOURCE cible. Cette fonction doit être inférieure à la valeur retournée par NetWakeSourceListGetCount.
Valeur retournée
Renvoie l’objet NETWAKESOURCE, qui représente la source de veille, à l’index spécifié dans la liste.
Remarques
Appelez NetWakeSourceListGetCount pour obtenir le nombre de sources de veille avant d’appeler cette fonction.
Le pilote client doit uniquement appeler NetWakeSourceListGetElement 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.
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 | netwakesourcelist.h (incluez netadaptercx.h) |
| Bibliothèque | netadaptercxstub.lib |
| IRQL | PASSIVE_LEVEL |