структура NET_POWER_OFFLOAD_LIST (netpoweroffloadlist.h)

Статья
05/23/2024

Структура NET_POWER_OFFLOAD_LIST представляет список выгрузок протокола с низким энергопотреблением для сетевого адаптера.

Синтаксис

typedef struct _NET_POWER_OFFLOAD_LIST {
  ULONG Size;
  void  *Reserved[4];
} NET_POWER_OFFLOAD_LIST;

Члены

Size

Размер этой структуры в байтах.

Reserved[4]

Зарезервировано. Клиентские драйверы не должны считывать или записывать это значение напрямую.

Вызовите NET_POWER_OFFLOAD_LIST_INIT , чтобы инициализировать эту структуру, а затем вызовите NetDeviceGetPowerOffloadList , чтобы получить список выгрузок с низким энергопотреблением для этого сетевого адаптера. Получив список, вызовите NetPowerOffloadListGetCount с этой структурой, чтобы получить количество объектов NETPOWEROFFLOAD, которые представляют разгрузки, а затем выполните цикл по объектам и вызовите NetPowerOffloadListGetElement , чтобы получить каждый из них. Получив объект NETPOWEROFFLOAD, вызовите NetPowerOffloadGetType , чтобы получить тип этой разгрузки, чтобы можно было вызвать соответствующую функцию для получения параметров разгрузки.

Драйвер клиента должен вызывать только функции, связанные с разгрузкой питания, во время перехода на питание, как правило, из функции обратного вызова 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)