NetWakeSourceListGetElement 函数从 net 适配器的唤醒源列表中获取唤醒源。
语法
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 回调函数。 否则,调用会导致系统 bug 检查。
有关使用 NETWAKESOURCE 对象的代码示例,请参阅 配置电源管理。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | Windows 10 版本 2004 |
目标平台 | 普遍 |
最低 UMDF 版本 | 2.33 |
标头 | netwakesourcelist.h (include netadaptercx.h) |
库 | netadaptercxstub.lib |
IRQL | PASSIVE_LEVEL |