WNV_REDIRECT_PARAM structure (wnvapi.h)

Specifies the parameters of the event (receiving an incoming Internet Control Message Protocol redirect packet) that causes the Windows Network Virtualization (WNV) driver to generate a WnvRedirectType notification. If there is a pending call to the WnvRequestNotification function of this type, the WNV driver fills the buffer that is passed in the NotificationParam argument's WNV_NOTIFICATION_PARAM structure with one or more instances of this structure and completes the WnvRequestNotification function call.

Syntax

typedef struct _WNV_REDIRECT_PARAM {
  ADDRESS_FAMILY CAFamily;
  ADDRESS_FAMILY PAFamily;
  ADDRESS_FAMILY NewPAFamily;
  ULONG          VirtualSubnetId;
  WNV_IP_ADDRESS CA;
  WNV_IP_ADDRESS PA;
  WNV_IP_ADDRESS NewPA;
} WNV_REDIRECT_PARAM, *PWNV_REDIRECT_PARAM;

Members

CAFamily

Type: ADDRESS_FAMILY

The address family (AF_INET or AF_INET6) for the customer address.

PAFamily

Type: ADDRESS_FAMILY

The address family (AF_INET or AF_INET6) for the original provider address.

NewPAFamily

Type: ADDRESS_FAMILY

The address family (AF_INET or AF_INET6) for the new provider address.

VirtualSubnetId

Type: ULONG

The identifier of a customer virtual subnet. This value ranges from 4096 (0x00001000) to 16777214 (0x00FFFFFE).

CA

Type: WNV_IP_ADDRESS

The IP address object for the customer address, which is the IP address configured on the virtual machine for network virtualization.

PA

Type: WNV_IP_ADDRESS

The IP address object for the provider address, which is the matching IP address used on the physical network for the customer address.

NewPA

Type: WNV_IP_ADDRESS

The updated provider address when a virtual machine is migrated from one host to another.

Remarks

Hyper-V Network Virtualization uses an Internet Control Message Protocol (ICMP) redirect message to indicate a change in the virtual machine's provider address in the case of a live migration of a virtual machine.

For a detailed description of network virtualization concepts and terminology, refer to Hyper-V Network Virtualization Overview.

Requirements

Requirement Value
Minimum supported client None supported
Minimum supported server Windows Server 2012 [desktop apps only]
Header wnvapi.h

See also

WNV_NOTIFICATION_TYPE