Функция 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 (include netadaptercx.h) |
| IRQL | PASSIVE_LEVEL |
См. также
настройка управления питанием