Функция 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 |
| Целевая платформа | Универсальное |
| Минимальная версия UMDF | 2.33 |
| Верхняя часть | netpoweroffloadlist.h (включая netadaptercx.h) |
| IRQL | PASSIVE_LEVEL |