NET_POWER_OFFLOAD_NS_PARAMETERS structure (netpoweroffload.h)

The NET_POWER_OFFLOAD_NS_PARAMETERS structure contains parameters for an IPv6 Neighbor Solicitation (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.

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

See also

Configuring power management

NET_POWER_OFFLOAD_NS_PARAMETERS_INIT

NetPowerOffloadGetNsParameters