Freigeben über


WifiPowerOffloadListGetElement-Funktion (wificxpoweroffloadlist.h)

Die WifiPowerOffloadListGetElement--Funktion ruft ein Offload aus einem Stromsparprotokoll aus einer Liste von Ausladungen zu einem WIFiCx-Netzadapter ab.

Syntax

WIFIPOWEROFFLOAD WifiPowerOffloadListGetElement(
  const WIFI_POWER_OFFLOAD_LIST *List,
  SIZE_T                        Index
);

Parameter

List

[In] Ein Zeiger auf eine vom Treiber zugewiesene und initialisierte WIFI_POWER_OFFLOAD_LIST Struktur.

Index

[In] Der nullbasierte Index in der Liste für das ZIEL-WIFIPOWEROFFLOAD-Objekt. Diese Funktion muss kleiner als der von WifiPowerOffloadListGetCountzurückgegebene Wert sein.

Rückgabewert

Gibt das WIFIPOWEROFFLOAD -Objekt zurück, das den Offload des Low-Power-Protokolls am angegebenen Index in der Liste darstellt.

Bemerkungen

Rufen Sie WifiPowerOffloadListGetCount- auf, um die Anzahl der Offloads des Low-Power-Protokolls abzurufen, bevor Sie diese Funktion aufrufen.

Der Clienttreiber darf nur WifiPowerOffloadListGetElement 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.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows 11
mindestens unterstützte Server- Windows Server 2022
Header- wificxpoweroffloadlist.h
IRQL- PASSIVE_LEVEL

Siehe auch

WIFI_POWER_OFFLOAD_LIST

WifiPowerOffloadListGetCount