NetPowerOffloadListGetElement 函数从卸载到 net 适配器的列表获取低功率协议卸载。
语法
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 回调函数。 否则，调用会导致系统 bug 检查。
有关使用 NETPOWEROFFLOAD 对象的代码示例，请参阅 配置电源管理。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | Windows 10 版本 2004 |
| 目标平台 | 普遍 |
| 最低 UMDF 版本 | 2.33 |
| 标头 | netpoweroffloadlist.h （包括 netadaptercx.h） |
| IRQL | PASSIVE_LEVEL |