NetPowerOffloadListGetElement-Funktion (netpoweroffloadlist.h)
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 |
| UMDF-Mindestversion | 2.33 |
| Kopfzeile | netpoweroffloadlist.h (include netadaptercx.h) |
| IRQL | PASSIVE_LEVEL |