NET_WAKE_SOURCE_LIST-Struktur (netwakesourcelist.h)

Artikel
05/23/2024

Die NET_WAKE_SOURCE_LIST-Struktur stellt eine Liste von WoL-Quellen (Wake-on-LAN) für einen Netzadapter dar.

Syntax

typedef struct _NET_WAKE_SOURCE_LIST {
  ULONG Size;
  void  *Reserved[4];
} NET_WAKE_SOURCE_LIST;

Member

Size

Die Größe dieser Struktur in Bytes.

Reserved[4]

Reserviert. Clienttreiber dürfen diesen Wert nicht direkt lesen oder schreiben.

Hinweise

Rufen Sie NET_WAKE_SOURCE_LIST_INIT auf, um diese Struktur zu initialisieren, und rufen Sie dann NetDeviceGetWakeSourceList auf, um die Liste der Reaktivierungsquellen aus diesem Netzwerkadapter abzurufen. Nachdem Sie die Liste abgerufen haben, rufen Sie NetWakeSourceListGetCount mit dieser Struktur auf, um die Anzahl der NETWAKESOURCE-Objekte abzurufen, die die Reaktivierungsquellen darstellen, und führen Sie dann eine Schleife über die Objekte aus, und rufen Sie NetWakeSourceListGetElement auf, um jedes objekt abzurufen. Nachdem Sie ein NETWAKESOURCE-Objekt abgerufen haben, rufen Sie NetWakeSourceGetType auf, um den Typ dieser Reaktivierungsquelle abzurufen, damit Sie die entsprechende Funktion aufrufen können, um die Parameter der Reaktivierungsquelle abzurufen.

Der Clienttreiber darf während eines Energieübergangs nur quellbezogene Wakefunktionen aufrufen, in der Regel von seiner 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.