NetPowerOffloadListGetElement 函数 (netpoweroffloadlist.h)
NetPowerOffloadListGetElement 函数从卸载列表获取低功率协议卸载到网络适配器。
语法
NETPOWEROFFLOAD NetPowerOffloadListGetElement(
[_In_] const NET_POWER_OFFLOAD_LIST *List,
[_In_] SIZE_T Index
);
参数
[_In_] List
指向驱动程序分配和初始化 NET_POWER_OFFLOAD_LIST 结构的指针。
[_In_] Index
目标 NETPOWEROFFLOAD 对象列表中从零开始的索引。 此函数必须小于 NetPowerOffloadListGetCount 返回的值。
返回值
返回 NETPOWEROFFLOAD 对象，该对象表示列表中的指定索引处的低功耗协议卸载。
注解
调用 NetPowerOffloadListGetCount 以获取低功率协议卸载数，然后再调用此函数。
客户端驱动程序只能在电源转换期间调用 NetPowerOffloadListGetElement ，通常是从其 EVT_WDF_DEVICE_ARM_WAKE_FROM_SX、 EVT_WDF_DEVICE_ARM_WAKE_FROM_S0或 EVT_NET_DEVICE_PREVIEW_POWER_OFFLOAD 回调函数。 否则，调用会导致系统错误检查。
有关使用 NETPOWEROFFLOAD 对象的代码示例，请参阅 配置电源管理。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 10 版本 2004 |
| 目标平台 | 通用 |
| 最低 UMDF 版本 | 2.33 |
| 标头 | netpoweroffloadlist.h (包括 netadaptercx.h) |
| IRQL | PASSIVE_LEVEL |