Freigeben über


NET_POWER_OFFLOAD_LIST_INIT-Funktion (netpoweroffloadlist.h)

Die NET_POWER_OFFLOAD_LIST_INIT-Funktion initialisiert eine NET_POWER_OFFLOAD_LIST-Struktur .

Syntax

void NET_POWER_OFFLOAD_LIST_INIT(
  [_Out_] NET_POWER_OFFLOAD_LIST *List
);

Parameter

[_Out_] List

Ein Handle für eine vom Treiber zugewiesene NET_POWER_OFFLOAD_LIST-Struktur .

Rückgabewert

Keine

Bemerkungen

Diese Funktion stellt den Arbeitsspeicher für die NET_POWER_OFFLOAD_LIST-Struktur auf Null und füllt dann das Element Größe aus. Rufen Sie nach dem Aufrufen dieser Funktion NetDeviceGetPowerOffloadList mit der initialisierten Struktur auf, um die Liste der stromarmen Auslagerungen auf diesen Netzadapter abzurufen.

Der Clienttreiber darf NET_POWER_OFFLOAD_LIST_INIT 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_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.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10, Version 2004
Zielplattform Universell
UMDF-Mindestversion 2.33
Kopfzeile netpoweroffloadlist.h (include netadaptercx.h)
IRQL Jede Ebene, solange der Zielspeicher resident ist

Weitere Informationen

Konfigurieren der Energieverwaltung

NET_POWER_OFFLOAD_LIST

NetDeviceGetPowerOffloadList