NET_POWER_OFFLOAD_LIST_INIT function (netpoweroffloadlist.h)

The NET_POWER_OFFLOAD_LIST_INIT function initializes a NET_POWER_OFFLOAD_LIST structure.

Syntax

void NET_POWER_OFFLOAD_LIST_INIT(
  [_Out_] NET_POWER_OFFLOAD_LIST *List
);

Parameters

[_Out_] List

A handle to a driver-allocated NET_POWER_OFFLOAD_LIST structure.

Return value

None

Remarks

This function zeros out the memory for the NET_POWER_OFFLOAD_LIST structure, then fills in the Size member. After calling this function, call NetDeviceGetPowerOffloadList with the initialized structure to get the list of low power offloads to this net adapter.

The client driver must only call NET_POWER_OFFLOAD_LIST_INIT during a power transition, typically from its EVT_WDF_DEVICE_ARM_WAKE_FROM_SX, EVT_WDF_DEVICE_ARM_WAKE_FROM_S0, or EVT_NET_DEVICE_PREVIEW_POWER_OFFLOAD callback function. Otherwise, the call results in a system bugcheck.

For a code sample of working with NETPOWEROFFLOAD objects, see Configuring power management.

Requirements

See also

Configuring power management

NET_POWER_OFFLOAD_LIST

NetDeviceGetPowerOffloadList