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

Функция 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, представляющий источник пробуждения по указанному индексу в списке.

Замечания

Вызовите NetWakeSourceListGetCount, чтобы получить количество источников пробуждения перед вызовом этой функции.

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

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

Требования

См. также

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

NET_WAKE_SOURCE_LIST

NetWakeSourceListGetCount