NetDeviceGetPowerOffloadList-Funktion (netpoweroffloadlist.h)
Die NetDeviceGetPowerOffloadList--Funktion ruft die Liste der Offloads mit geringem Stromverbrauch auf einen Netzadapter ab.
Syntax
void NetDeviceGetPowerOffloadList(
[_In_] WDFDEVICE Device,
[_Inout_] NET_POWER_OFFLOAD_LIST *List
);
Parameter
[_In_] Device
Das dem Netzadapter zugeordnete WDFDEVICE-Objekt.
[_Inout_] List
Ein Zeiger auf eine vom Treiber zugewiesene und initialisierte NET_POWER_OFFLOAD_LIST Struktur.
Rückgabewert
Nichts
Bemerkungen
Rufen Sie NET_POWER_OFFLOAD_LIST_INIT auf, um die NET_POWER_OFFLOAD_LIST Struktur zu initialisieren, und rufen Sie diese Funktion auf, um die Offloadliste für das Low-Power-Protokoll abzurufen.
Der Clienttreiber darf nur NetDeviceGetPowerOffloadList- während eines Stromübergangs aufrufen, in der Regel von der 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 das Arbeiten mit NETPOWEROFFLOAD-Objekten finden Sie unter Konfigurieren der Energieverwaltung.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 10, Version 2004 |
| Zielplattform- | Universal |
| Mindest-UMDF-Version | 2.33 |
| Header- | netpoweroffloadlist.h (include netadaptercx.h) |
| IRQL- | PASSIVE_LEVEL |