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 den Member Größe aus. Nachdem Sie diese Funktion aufgerufen haben, rufen Sie NetDeviceGetPowerOffloadList mit der initialisierten Struktur auf, um die Liste der Stromabladungen für 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 für die Arbeit mit NETPOWEROFFLOAD-Objekten finden Sie unter Konfigurieren der Energieverwaltung.

Anforderungen

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

Weitere Informationen

Konfigurieren der Energieverwaltung

NET_POWER_OFFLOAD_LIST

NetDeviceGetPowerOffloadList