Функция WifiPowerOffloadListGetElement (wificxpoweroffloadlist.h)

  • Статья

Функция WifiPowerOffloadListGetElement получает разгрузку протокола низкого энергопотребления из списка разгрузки на сетевой адаптер WiFiCx.

Синтаксис

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

Параметры

List

[Вход] Указатель на структуру, выделенную драйвером и инициализированную WIFI_POWER_OFFLOAD_LIST .

Index

[Вход] Отсчитываемый от нуля индекс в списке для целевого объекта WIFIPOWEROFFLOAD. Эта функция должна быть меньше значения, возвращаемого WifiPowerOffloadListGetCount.

Возвращаемое значение

Возвращает объект WIFIPOWEROFFLOAD, представляющий разгрузку протокола низкого энергопотребления по указанному индексу в списке.

Комментарии

Вызовите WifiPowerOffloadListGetCount , чтобы получить количество разгрузки протокола с низким энергопотреблением перед вызовом этой функции.

Драйвер клиента должен вызывать WifiPowerOffloadListGetElement только во время перехода на питание, обычно из функции обратного вызова EVT_WDF_DEVICE_ARM_WAKE_FROM_SX, EVT_WDF_DEVICE_ARM_WAKE_FROM_S0 или EVT_NET_DEVICE_PREVIEW_POWER_OFFLOAD . В противном случае вызов приводит к системной ошибке.

Требования

Требование Значение
Минимальная версия клиента Windows 11
Минимальная версия сервера Windows Server 2022
Верхняя часть wificxpoweroffloadlist.h
IRQL PASSIVE_LEVEL

См. также раздел

WIFI_POWER_OFFLOAD_LIST

WifiPowerOffloadListGetCount