структура NET_WAKE_SOURCE_LIST (netwakesourcelist.h)

Статья
05/23/2024

Структура NET_WAKE_SOURCE_LIST представляет список источников пробуждения по локальной сети (WoL) для сетевого адаптера.

Синтаксис

typedef struct _NET_WAKE_SOURCE_LIST {
  ULONG Size;
  void  *Reserved[4];
} NET_WAKE_SOURCE_LIST;

Члены

Size

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

Reserved[4]

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

Вызовите NET_WAKE_SOURCE_LIST_INIT для инициализации этой структуры, а затем вызовите NetDeviceGetWakeSourceList , чтобы получить список источников пробуждения от этого сетевого адаптера. Получив список, вызовите NetWakeSourceListGetCount с этой структурой, чтобы получить количество объектов NETWAKESOURCE, представляющих источники пробуждения, а затем выполните цикл по объектам и вызовите NetWakeSourceListGetElement , чтобы получить каждый из них. Получив объект NETWAKESOURCE, вызовите NetWakeSourceGetType , чтобы получить тип этого источника пробуждения, чтобы можно было вызвать соответствующую функцию для получения параметров источника пробуждения.

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

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

Требования

Требование	Значение
Минимальная версия клиента	Windows 10 версии 2004
Минимальная версия UMDF	2.33
Верхняя часть	netwakesourcelist.h (включая netadaptercx.h)