NetWakeSourceListGetElement, fonction (netwakesourcelist.h)
La fonction NetWakeSourceListGetElement obtient une source de mise en éveil dans 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 par le pilote et initialisée.
[_In_] Index
Index de base zéro dans la liste de l’objet NETWAKESOURCE cible. Cette fonction doit être inférieure à la valeur retournée par NetWakeSourceListGetCount.
Valeur de retour
Renvoie l’objet NETWAKESOURCE, qui représente la source de sortie 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 de puissance, généralement à partir de son 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 |
| plateforme cible | Universel |
| version minimale de UMDF | 2.33 |
| d’en-tête | netwakesourcelist.h (include netadaptercx.h) |
| bibliothèque | netadaptercxstub.lib |
| IRQL | PASSIVE_LEVEL |
Voir aussi
Configuration des de gestion de l’alimentation