NetWakeSourceListGetElement 函数(netwakesourcelist.h)

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_SXEVT_WDF_DEVICE_ARM_WAKE_FROM_S0EVT_NET_DEVICE_PREVIEW_WAKE_SOURCE 回调函数。 否则,调用会导致系统 bug 检查。

有关使用 NETWAKESOURCE 对象的代码示例,请参阅 配置电源管理

要求

要求 价值
最低支持的客户端 Windows 10 版本 2004
目标平台 普遍
最低 UMDF 版本 2.33
标头 netwakesourcelist.h (include netadaptercx.h)
netadaptercxstub.lib
IRQL PASSIVE_LEVEL

另请参阅

配置电源管理

NET_WAKE_SOURCE_LIST

NetWakeSourceListGetCount