NET_POWER_OFFLOAD_LIST-Struktur (netpoweroffloadlist.h)
Die NET_POWER_OFFLOAD_LIST-Struktur stellt eine Liste der Low Power Protocol-Auslagerungen 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 geringen Stromabladungen für 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. Führen Sie dann eine Schleife über die Objekte aus, und rufen Sie NetPowerOffloadListGetElement auf, um die einzelnen Objekte abzurufen. Nachdem Sie ein NETPOWEROFFLOAD-Objekt abgerufen haben, rufen Sie NetPowerOffloadGetType auf, um den Typ dieser Auslagerung abzurufen, sodass Sie die entsprechende Funktion aufrufen können, um die Parameter der Auslagerung abzurufen.
Der Clienttreiber darf während eines Energieübergangs nur funktionen zur Stromabladung 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 |
| UMDF-Mindestversion | 2.33 |
| Kopfzeile | netpoweroffloadlist.h (include netadaptercx.h) |