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

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