NetWakeSourceListGetElement-Funktion (netwakesourcelist.h)
Die NetWakeSourceListGetElement-Funktion ruft eine Aktivierungsquelle aus der Liste der Aktivierungsquellen für einen Netzadapter ab.
Syntax
NETWAKESOURCE NetWakeSourceListGetElement(
[_In_] const NET_WAKE_SOURCE_LIST *List,
[_In_] SIZE_T Index
);
Parameter
[_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 NetWakeSourceListGetCount zurückgegebene Wert sein.
Rückgabewert
Gibt das NETWAKESOURCE-Objekt, das die Aktivierungsquelle darstellt, am angegebenen Index in der Liste zurück.
Hinweise
Rufen Sie NetWakeSourceListGetCount auf, um die Anzahl der Aktivierungsquellen abzurufen, bevor Sie diese Funktion aufrufen.
Der Clienttreiber darf NetWakeSourceListGetElement nur während eines Energieübergangs aufrufen, in der Regel über seine 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.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10, Version 2004 |
| Zielplattform | Universell |
| UMDF-Mindestversion | 2.33 |
| Kopfzeile | netwakesourcelist.h (include netadaptercx.h) |
| Bibliothek | netadaptercxstub.lib |
| IRQL | PASSIVE_LEVEL |