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) |
| Library | netadaptercxstub.lib |
| IRQL | PASSIVE_LEVEL |