NET_WAKE_SOURCE_LIST Struktur (netwakesourcelist.h)
Die NET_WAKE_SOURCE_LIST-Struktur stellt eine Liste der Wake-on-LAN (WoL)-Quellen für einen Netzadapter dar.
Syntax
typedef struct _NET_WAKE_SOURCE_LIST {
ULONG Size;
void *Reserved[4];
} NET_WAKE_SOURCE_LIST;
Angehörige
Size
Die Größe dieser Struktur in Byte.
Reserved[4]
Reserviert. Clienttreiber dürfen diesen Wert nicht direkt lesen oder schreiben.
Bemerkungen
Rufen Sie NET_WAKE_SOURCE_LIST_INIT auf, um diese Struktur zu initialisieren, und rufen Sie dann NetDeviceGetWakeSourceList- auf, um die Liste der Wakequellen von diesem Netzadapter abzurufen. Rufen Sie nach dem Abrufen der Liste NetWakeSourceListGetCount mit dieser Struktur auf, um die Anzahl der NETWAKESOURCE-Objekte abzurufen, die die Wakequellen darstellen, und durchlaufen Sie dann die Objekte, und rufen Sie NetWakeSourceListGetElement auf, um die einzelnen Objekte abzurufen. Nachdem Sie ein NETWAKESOURCE-Objekt abgerufen haben, rufen Sie NetWakeSourceGetType- auf, um den Typ dieser Wake-Quelle abzurufen, damit Sie die entsprechende Funktion aufrufen können, um die Parameter der Wake-Quelle abzurufen.
Der Clienttreiber darf während eines Stromübergangs nur wake source-bezogene Funktionen aufrufen, in der Regel von seinem EVT_WDF_DEVICE_ARM_WAKE_FROM_SX, EVT_WDF_DEVICE_ARM_WAKE_FROM_S0oder 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 |
Mindest-UMDF-Version | 2.33 |
Header- | netwakesourcelist.h (include netadaptercx.h) |