Функция 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 см. в разделе Настройка управления питанием.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 10 версии 2004 |
| Целевая платформа | Универсальное |
| Минимальная версия UMDF | 2.33 |
| Верхняя часть | netwakesourcelist.h (включая netadaptercx.h) |
| Библиотека | netadaptercxstub.lib |
| IRQL | PASSIVE_LEVEL |