NET_POWER_OFFLOAD_LIST Struktur (netpoweroffloadlist.h)

Artikel
02/29/2024

Die NET_POWER_OFFLOAD_LIST-Struktur stellt eine Liste von Protokollen mit geringer Leistung an einen Netzadapter dar.

Syntax

typedef struct _NET_POWER_OFFLOAD_LIST {
  ULONG Size;
  void  *Reserved[4];
} NET_POWER_OFFLOAD_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_POWER_OFFLOAD_LIST_INIT auf, um diese Struktur zu initialisieren, und rufen Sie dann NetDeviceGetPowerOffloadList auf, um die Liste der stromarmen Auslagerungen auf diesen Netzadapter abzurufen. Nachdem Sie die Liste abgerufen haben, rufen Sie NetPowerOffloadListGetCount mit dieser Struktur auf, um die Anzahl der NETPOWEROFFLOAD-Objekte abzurufen, die die Auslagerungen darstellen, und führen Sie dann eine Schleife über die Objekte aus, und rufen Sie NetPowerOffloadListGetElement auf, um jedes objekt abzurufen. Nachdem Sie ein NETPOWEROFFLOAD-Objekt abgerufen haben, rufen Sie NetPowerOffloadGetType auf, um den Typ dieser Abladung abzurufen, damit Sie die entsprechende Funktion aufrufen können, um die Parameter der Auslagerung abzurufen.

Der Clienttreiber darf während eines Energieübergangs nur Funktionen im Zusammenhang mit der Auslagerung 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_POWER_OFFLOAD Rückruffunktion. Andernfalls führt der Aufruf zu einer Systemfehlerüberprüfung.

Ein Codebeispiel zum Arbeiten mit NETPOWEROFFLOAD-Objekten finden Sie unter Konfigurieren der Energieverwaltung.