Edit

NET_POWER_OFFLOAD_NS_PARAMETERS structure (netpoweroffload.h)

  • Article

The NET_POWER_OFFLOAD_NS_PARAMETERS structure contains parameters for an IPv6 Neighbor Solitication (NS) low power protocol offload to a net adapter.

Syntax

typedef struct _NET_POWER_OFFLOAD_NS_PARAMETERS {
  ULONG                          Size;
  ULONG                          Id;
  NET_IPV6_ADDRESS               RemoteIPv6Address;
  NET_IPV6_ADDRESS               SolicitedNodeIPv6Address;
  NET_IPV6_ADDRESS               TargetIPv6Addresses[2];
  NET_ADAPTER_LINK_LAYER_ADDRESS LinkLayerAddress;
} NET_POWER_OFFLOAD_NS_PARAMETERS;

Members

Size

The size of this structure, in bytes.

Id

The identifier for this protocol offload.

RemoteIPv6Address

The Source Address Field in the IPv6 header of the NS message. This member is optional.

If the incoming NS message has a Source Address value that matches this IPv6 address, the net adapter sends a neighbor advertisement (NA) message when it is in a low power state. If this member is zero, the net adapter should respond to NS messages from any remote IPv6 address.

SolicitedNodeIPv6Address

The solicited node IPv6 address.

TargetIPv6Addresses[2]

An array that contains one or two IPv6 addresses. If it contains only one address, that address is stored in the first element in the array and the second element is filled with zeros.

Client drivers must consume all addresses in the array.

These addresses represent the Target Address field of an NS message. If one of these addresses matches the Target Address field of an incoming NS message, the net adapter sends an NA message in response.

LinkLayerAddress

The media access control (MAC) address. When it sends the NA message, the net adapter uses this address for the target link layer address (TLLA) field of the NA message.

Note

When it sends an NA message, the net adapter must always use this MAC address in the TLLA field of the NA message. However, it should use the current MAC address of the net adapter as the source address in the MAC header.

Remarks

Call NET_POWER_OFFLOAD_NS_PARAMETERS_INIT to initialize this structure and fill in its Size field. After calling NET_POWER_OFFLOAD_NS_PARAMETERS_INIT, call NetPowerOffloadGetNsParameters to fill in the remaining members of the structure.

For more information about IPv6 NS and NA messages, see RFC 4861.

Requirements

Requirement Value
Minimum supported client Windows 10, version 2004
Header netpoweroffload.h (include netadaptercx.h)

See also

Configuring power management

NET_POWER_OFFLOAD_NS_PARAMETERS_INIT

NetPowerOffloadGetNsParameters