Hyper-V Rozszerzalne typy danych kontekstowych przekazywania przełącznika

The NET_BUFFER_LIST structure for each packet that traverses the Hyper-V extensible switch data path contains out-of-band (OOB) data. Te dane określają port źródłowy, z którego pochodzi pakiet, a także co najmniej jeden port docelowy do dostarczania pakietów. Dane OOB są znane jako kontekst przekazywania rozszerzalnego przełącznika.

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
Jest to 64-bitowa unia zawierająca cechy przekazywania pakietu. Te dane obejmują identyfikatory portu źródłowego i połączenia karty sieciowej, z którego pochodzi pakiet. Te dane obejmują również liczbę nieużywanych elementów dostępnych w tablicy portów docelowych.

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

NDIS_SWITCH_FORWARDING_DESTINATION_ARRAY
Ta struktura definiuje docelową tablicę portów dla pakietu. 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. Ta funkcja zatwierdza te zmiany w tablicy portów docelowych w kontekście przekazywania pakietu.

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
Ta struktura definiuje port docelowy pakietu. For packets with a single destination port, there is only one NDIS_SWITCH_PORT_DESTINATION element in the destination port array. W przypadku pakietów z wieloma portami docelowymi istnieje co najmniej jeden z tych elementów w tablicy.

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.