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
目标平台 通用
标头 netwakesourcelist.h (包括 netadaptercx.h)
Library netadaptercxstub.lib
IRQL PASSIVE_LEVEL

另请参阅

配置电源管理

NET_WAKE_SOURCE_LIST

NetWakeSourceListGetCount