NetWakeSourceListGetElement-Funktion (netwakesourcelist.h)
Die NetWakeSourceListGetElement--Funktion ruft eine Wake-Quelle aus der Liste der Wakequellen für einen Netzadapter ab.
NETWAKESOURCE NetWakeSourceListGetElement(
[_In_] const NET_WAKE_SOURCE_LIST *List,
[_In_] SIZE_T Index
);
[_In_] List
Ein Handle für eine vom Treiber zugewiesene und initialisierte NET_WAKE_SOURCE_LIST Struktur.
[_In_] Index
Der nullbasierte Index in der Liste für das NetWAKESOURCE-Zielobjekt. Diese Funktion muss kleiner als der von NetWakeSourceListGetCountzurückgegebene Wert sein.
Gibt das NETWAKESOURCE -Objekt, das die Wake-Quelle darstellt, am angegebenen Index in der Liste zurück.
Rufen Sie NetWakeSourceListGetCount- auf, um die Anzahl der Wake-Quellen abzurufen, bevor Sie diese Funktion aufrufen.
Der Clienttreiber darf nur NetWakeSourceListGetElement- während eines Stromübergangs aufrufen, in der Regel von der EVT_WDF_DEVICE_ARM_WAKE_FROM_SX-, EVT_WDF_DEVICE_ARM_WAKE_FROM_S0- oder EVT_NET_DEVICE_PREVIEW_WAKE_SOURCE Rückruffunktion. Andernfalls führt der Aufruf zu einer Systemfehlerüberprüfung.
Ein Codebeispiel zum Arbeiten mit NETWAKESOURCE-Objekten finden Sie unter Konfigurieren der Energieverwaltung.
Anforderung | Wert |
---|---|
mindestens unterstützte Client- | Windows 10, Version 2004 |
Zielplattform- | Universal |
Mindest-UMDF-Version | 2.33 |
Header- | netwakesourcelist.h (include netadaptercx.h) |
Library | netadaptercxstub.lib |
IRQL- | PASSIVE_LEVEL |