Hyper-V tipos de datos de contexto de reenvío extensible de conmutadores

The NET_BUFFER_LIST structure for each packet that traverses the Hyper-V extensible switch data path contains out-of-band (OOB) data. Estos datos especifican el puerto de origen desde el que se originó el paquete, así como uno o varios puertos de destino para la entrega de paquetes. Estos datos de OOB se conocen como el contexto de reenvío de conmutadores extensible.

The following data types have been declared to access the extensible switch forwarding context within a packet's NET_BUFFER_LIST structure:

NDIS_SWITCH_FORWARDING_DETAIL_NET_BUFFER_LIST_INFO
Se trata de una unión de 64 bits que contiene las características de reenvío de un paquete. Estos datos incluyen los identificadores del puerto de origen y la conexión del adaptador de red desde el que se originó el paquete. Estos datos también incluyen el número de elementos sin usar que están disponibles en la matriz de puertos de destino.

The extensible switch extension can access this data by using the NET_BUFFER_LIST_SWITCH_FORWARDING_DETAIL macro.

NDIS_SWITCH_FORWARDING_DESTINATION_ARRAY
Esta estructura define la matriz de puertos de destino para el paquete. Each element in this array is formatted as an NDIS_SWITCH_PORT_DESTINATION structure.

The NDIS_SWITCH_FORWARDING_DESTINATION_ARRAY structure contains members that specify the current number of the total number of elements as well as the number of used elements in the array.

The extensible switch extension can obtain this array by calling the GetNetBufferListDestinations function. If the driver adds or modifies elements in the array for a packet with multiple destination ports, it must call the UpdateNetBufferListDestinations function. Esta función confirma esos cambios en la matriz de puertos de destino en el contexto de reenvío del paquete.

Note To commit changes to a packet with only one destination port, it is more efficient for the driver to call the AddNetBufferListDestination function.

NDIS_SWITCH_PORT_DESTINATION
Esta estructura define un puerto de destino para el paquete. For packets with a single destination port, there is only one NDIS_SWITCH_PORT_DESTINATION element in the destination port array. En el caso de los paquetes con varios puertos de destino, hay uno o varios de estos elementos en la matriz.

After the extensible switch extension has called GetNetBufferListDestinations to obtain the packet's destination port array, it can access individual elements in the array by using the NDIS_SWITCH_PORT_DESTINATION_AT_ARRAY_INDEX macro.