netpoweroffloadlist.h (NET_POWER_OFFLOAD_LIST 结构)

NET_POWER_OFFLOAD_LIST 结构表示到网卡的低功率协议卸载列表。

语法

typedef struct _NET_POWER_OFFLOAD_LIST {
  ULONG Size;
  void  *Reserved[4];
} NET_POWER_OFFLOAD_LIST;

Size

此结构的大小（以字节为单位）。

Reserved[4]

保留。客户端驱动程序不得直接读取或写入此值。

调用 NET_POWER_OFFLOAD_LIST_INIT 初始化此结构，然后调用 NetDeviceGetPowerOffloadList 以获取此网络适配器的低功率卸载列表。获取列表后，使用此结构调用 NetPowerOffloadListGetCount 以获取表示卸载的 NETPOWEROFFLOAD 对象的数量，然后循环访问对象并调用 NetPowerOffloadListGetElement 来检索每个对象。获取 NETPOWEROFFLOAD 对象后，调用 NetPowerOffloadGetType 以获取该卸载的类型，以便可以调用相应的函数来获取卸载的参数。

客户端驱动程序只能在电源转换期间调用与断电相关的函数，通常从其 EVT_WDF_DEVICE_ARM_WAKE_FROM_SX、 EVT_WDF_DEVICE_ARM_WAKE_FROM_S0或 EVT_NET_DEVICE_PREVIEW_POWER_OFFLOAD 回调函数调用。否则，调用会导致系统 bug 检查。

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