Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die NetWakeSourceListGetElement--Funktion ruft eine Wake-Quelle aus der Liste der Wakequellen 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 NetWakeSourceListGetCountzurückgegebene Wert sein.
Rückgabewert
Gibt das NETWAKESOURCE -Objekt, das die Wake-Quelle darstellt, am angegebenen Index in der Liste zurück.
Bemerkungen
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.
Anforderungen
| 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 |