NDIS_SWITCH_PORT_DESTINATION structure (ndis.h)

  • Article

The NDIS_SWITCH_PORT_DESTINATION structure specifies the Hyper-V extensible switch destination port to which a packet will be delivered.

Syntax

typedef struct _NDIS_SWITCH_PORT_DESTINATION {
  NDIS_SWITCH_PORT_ID   PortId;
  NDIS_SWITCH_NIC_INDEX NicIndex;
  USHORT                IsExcluded : 1;
  USHORT                PreserveVLAN : 1;
  USHORT                PreservePriority : 1;
  USHORT                Reserved : 13;
} NDIS_SWITCH_PORT_DESTINATION, *PNDIS_SWITCH_PORT_DESTINATION;

Members

PortId

An NDIS_SWITCH_PORT_ID value that specifies the unique identifier of the destination port on the extensible switch.

NicIndex

An NDIS_SWITCH_NIC_INDEX value that specifies the index of the network adapter that is connected to the extensible switch port specified by the PortId member.

For more information on NDIS_SWITCH_NIC_INDEX values, see Network Adapter Index Values.

Note  This member must specify the index value of a network adapter that is in a connected state. Index values for network adapters that are in a created or disconnected state cannot be specified. For more information about network connection states, see Hyper-V Extensible Switch Port and Network Adapter States.
 

IsExcluded

If this member is set to TRUE, the packet will not be delivered to the destination port.

PreserveVLAN

If this member is set to TRUE, the 802.1Q virtual local area network (VLAN) information will be preserved when the packet is delivered to the destination port.

PreservePriority

If this member is set to TRUE, the 802.1Q priority information will be preserved when the packet is delivered to the destination port.

Reserved

This member is reserved for future use by NDIS.

Remarks

The NDIS_SWITCH_FORWARDING_DESTINATION_ARRAY contains one or more elements. Each element is formatted as an NDIS_SWITCH_PORT_DESTINATION structure.

Note  The NicIndex member must specify the index value of a network adapter that is in a connected state. Index values for network adapters that are in a created or disconnected state cannot be specified. For more information about network connection states, see Hyper-V Extensible Switch Port and Network Adapter States.
 
For more information on destination ports, see Managing Hyper-V Extensible Switch Destination Port Data.

Requirements

Requirement Value
Minimum supported client Supported in NDIS 6.30 and later.
Header ndis.h (include Ndis.h)

See also

NDIS_SWITCH_FORWARDING_DESTINATION_ARRAY