Функция NetWakeSourceListGetElement (netwakesourcelist.h)

Статья
08/07/2023

Функция NetWakeSourceListGetElement получает источник пробуждения из списка источников пробуждения для сетевого адаптера.

Синтаксис

NETWAKESOURCE NetWakeSourceListGetElement(
  [_In_] const NET_WAKE_SOURCE_LIST *List,
  [_In_] SIZE_T                     Index
);

Параметры

[_In_] List

Дескриптор структуры, выделенной драйвером и инициализированной NET_WAKE_SOURCE_LIST .

[_In_] Index

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

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

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

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

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

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

NET_WAKE_SOURCE_LIST

NetWakeSourceListGetCount

Поделиться через