NetPowerOffloadListGetCount-Funktion (netpoweroffloadlist.h)
Die NetPowerOffloadListGetCount-Funktion ruft die Anzahl der Protokollauslagerungen mit geringer Leistung an einen Netzadapter ab.
Syntax
SIZE_T NetPowerOffloadListGetCount(
[_In_] const NET_POWER_OFFLOAD_LIST *List
);
Parameter
[_In_] List
Ein Zeiger auf eine vom Treiber zugewiesene und initialisierte NET_POWER_OFFLOAD_LIST Struktur.
Rückgabewert
Gibt die Anzahl der stromarmen Auslagerungen an diesen Netzadapter zurück.
Hinweise
Rufen Sie NET_POWER_OFFLOAD_LIST_INIT auf, um die NET_POWER_OFFLOAD_LIST-Struktur zu initialisieren, und rufen Sie dann NetDeviceGetPowerOffloadList auf, um die Protokollabladungsliste mit niedriger Leistung abzurufen. Nachdem Sie die Liste abgerufen haben, rufen Sie diese Funktion auf, um zu bestimmen, wie viele Protokollauslagerungen für diesen Netzadapter vorhanden sind.
Der Clienttreiber darf NetPowerOffloadListGetCount 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 zum Arbeiten 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 |