Функция NetPowerOffloadListGetElement (netpoweroffloadlist.h)

  • Статья

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

Синтаксис

NETPOWEROFFLOAD NetPowerOffloadListGetElement(
  [_In_] const NET_POWER_OFFLOAD_LIST *List,
  [_In_] SIZE_T                       Index
);

Параметры

[_In_] List

Указатель на структуру, выделенную драйвером и инициализированную NET_POWER_OFFLOAD_LIST .

[_In_] Index

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

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

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

Комментарии

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

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

Пример кода для работы с объектами NETPOWEROFFLOAD см. в разделе Настройка управления питанием.

Требования

Требование Значение
Минимальная версия клиента Windows 10 версии 2004
Целевая платформа Универсальное
Верхняя часть netpoweroffloadlist.h (включая netadaptercx.h)
IRQL PASSIVE_LEVEL

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

Настройка функций управления питанием

NET_POWER_OFFLOAD_LIST

NetPowerOffloadListGetCount