NetPowerOffloadListGetElement-Funktion (netpoweroffloadlist.h)

  • Artikel

Die NetPowerOffloadListGetElement-Funktion ruft eine Protokollauslagerung mit niedriger Leistung aus einer Liste von Auslagerungen auf einen Netzadapter ab.

Syntax

NETPOWEROFFLOAD NetPowerOffloadListGetElement(
  [_In_] const NET_POWER_OFFLOAD_LIST *List,
  [_In_] SIZE_T                       Index
);

Parameter

[_In_] List

Ein Zeiger auf eine vom Treiber zugewiesene und initialisierte NET_POWER_OFFLOAD_LIST-Struktur .

[_In_] Index

Der nullbasierte Index in der Liste für das NETPOWEROFFLOAD-Zielobjekt. Diese Funktion muss kleiner als der von NetPowerOffloadListGetCount zurückgegebene Wert sein.

Rückgabewert

Gibt das NETPOWEROFFLOAD-Objekt zurück, das die Low Power Protocol Offload am angegebenen Index in der Liste darstellt.

Hinweise

Rufen Sie NetPowerOffloadListGetCount auf, um vor dem Aufrufen dieser Funktion die Anzahl der Low-Power-Protokollauslagerungen abzurufen.

Der Clienttreiber darf NetPowerOffloadListGetElement 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 PASSIVE_LEVEL

Weitere Informationen

Konfigurieren der Energieverwaltung

NET_POWER_OFFLOAD_LIST

NetPowerOffloadListGetCount