Udostępnij za pośrednictwem

OID_SWITCH_NIC_REQUEST

Żądanie metody identyfikatora obiektu (OID) OID_SWITCH_NIC_REQUEST służy do hermetyzacji i przekazywania żądań OID do Hyper-V rozszerzalnej karty sieciowej przełącznika zewnętrznego. Pozwala to na dostarczenie hermetyzowanego żądania OID do sterownika dla podstawowej fizycznej karty sieciowej powiązanej z zewnętrzną kartą sieciową.

To żądanie identyfikatora OID jest również używane do hermetyzacji żądań OID, które zostały wystawione dla innych kart sieciowych podłączonych do rozszerzalnych portów przełącznika. W takim przypadku hermetyzowane żądanie identyfikatora OID jest przekazywane za pośrednictwem rozszerzalnego stosu sterowników przełącznika do inspekcji przez rozszerzenia.

Element InformationBuffer struktury NDIS_OID_REQUEST zawiera wskaźnik do struktury NDIS_SWITCH_NIC_OID_REQUEST. Ta struktura określa przekazywanie informacji dla żądania OID. Ta struktura zawiera również wskaźnik do oryginalnej NDIS_OID_REQUEST struktury żądania OID, który jest przekazywany.

Uwagi

Gdy żądania OID docierają do interfejsu przełącznika rozszerzalnego Hyper-V, hermetyzuje je w celu przekazania ich w dół rozszerzalnej ścieżki sterowania przełącznika. Te żądania OID obejmują następujące elementy:

  • Sprzętowe żądania OID odciążania, w tym żądania zabezpieczeń protokołu internetowego (IPsec), kolejki maszyn wirtualnych (VMQ) i wirtualizacji we/wy pojedynczego głównego (SR-IOV). Te żądania OID są wydawane przez nadmiernie działający protokół lub sterownik filtru w systemie operacyjnym zarządzania partycji nadrzędnej Hyper-V.

    Gdy te żądania OID docierają do rozszerzalnego interfejsu przełącznika, krawędź protokołu rozszerzalnego przełącznika hermetyzuje żądanie OID w strukturze NDIS_SWITCH_NIC_OID_REQUEST. Krawędź protokołu ustawia elementy członkowskie tej struktury w następujący sposób:

    • Elementy członkowskie DestinationPortId i DestinationNicIndex są ustawione na odpowiednie wartości dla zewnętrznej karty sieciowej.

    • Jeśli żądanie identyfikatora OID pochodzi z partycji podrzędnej Hyper-V, SourcePortId i elementy członkowskie SourceNicIndex są ustawione na odpowiednie wartości dla portu i karty sieciowej używanej przez partycję. W przeciwnym razie składowe SourcePortId i SourceNicIndex są ustawione na zero.

      Uwaga Rozszerzenie musi zachować wartości tych elementów członkowskich, jeśli przekazuje lub przekierowuje żądanie OID.

    • Element członkowski OidRequest jest ustawiony na wskaźnik do struktury NDIS_OID_REQUEST dla hermetyzowanego żądania identyfikatora OID.

    Następnie krawędź protokołu wysyła żądanie OID_SWITCH_NIC_REQUEST, aby przekazać żądanie hermetyzowanego identyfikatora OID w dół rozszerzalnej ścieżki sterowania przełącznika do zewnętrznej karty sieciowej.

    Podstawowe rozszerzenie przekazywania może przekierowywać hermetyzowane żądania odciążania sprzętu OID do fizycznej karty sieciowej powiązanej z zewnętrzną kartą sieciową. Jeśli na przykład rozszerzenie obsługuje fizyczne karty sieciowe od zespołu rozszerzalnego przełącznika powiązanego z zewnętrzną kartą sieciową, może przekazać żądanie OID_SWITCH_NIC_REQUEST do karty fizycznej w zespole równoważenia obciążenia trybu failover (LBFO), który obsługuje odciążanie sprzętu. Aby uzyskać więcej informacji na temat tej procedury, zobacz Zarządzanie odciążania sprzętu żądaniami OID do fizycznych kart sieciowych.

    Aby uzyskać więcej informacji na temat rozszerzalnych zespołów przełączników, zobacz Typy konfiguracji fizycznej karty sieciowej.

  • Żądania OID multiemisji, w tym OID_802_3_ADD_MULTICAST_ADDRESS i OID_802_3_DELETE_MULTICAST_ADDRESS. Te żądania identyfikatora OID są wydawane przez nadmierny protokół i sterowniki filtrów uruchamiane w systemie operacyjnym zarządzania lub systemie operacyjnym gościa partycji podrzędnej Hyper-V.

    Gdy te żądania OID docierają do rozszerzalnego interfejsu przełącznika, krawędź protokołu rozszerzalnego przełącznika hermetyzuje żądanie OID w strukturze NDIS_SWITCH_NIC_OID_REQUEST. Krawędź protokołu ustawia również SourcePortId i elementy członkowskie SourceNicIndex odpowiednie wartości dla portu i karty sieciowej, z której pochodzi żądanie OID. Następnie krawędź protokołu wysyła żądanie OID_SWITCH_NIC_REQUEST do przekazania hermetyzowanego żądania identyfikatora OID w dół rozszerzalnej ścieżki sterowania przełącznika do inspekcji przez podstawowe rozszerzenia.

    Uwaga W tym przypadku krawędź protokołu ustawia DestinationPortId i DestinationNicIndex składowych na zero. Określa to, że hermetyzowane żądanie OID ma zostać dostarczone do rozszerzeń w ścieżce sterowania.

    Podstawowe rozszerzenia przesyłania dalej mogą sprawdzać te hermetyzowane żądania OID i zachowywać informacje o adresach multiemisji, które określają. Na przykład rozszerzenie może potrzebować tych informacji, jeśli pochodzi z pakietów multiemisji, które przekazuje do rozszerzalnego portu przełącznika.

    Aby uzyskać więcej informacji, zobacz Przekazywanie żądań OID z partycji podrzędnej Hyper-V.

Rozszerzenie przekazujące może również wydać OID_SWITCH_NIC_REQUEST w celu przekazywania hermetyzowanych żądań OID do fizycznej karty sieciowej powiązanej z zewnętrzną kartą sieciową. Dzięki temu rozszerzenie może pochodzić z własnego żądania identyfikatora OID lub przekierować istniejące żądanie identyfikatora OID do fizycznej karty sieciowej powiązanej z zewnętrzną kartą sieciową. Aby to zrobić, rozszerzenie musi wykonać następujące kroki:

  1. Rozszerzenie wywołuje ReferenceSwitchNic, aby zwiększać licznik odwołania dla indeksu docelowej fizycznej karty sieciowej. Gwarantuje to, że rozszerzalny interfejs przełącznika nie usunie fizycznego połączenia karty sieciowej, podczas gdy jego licznik odniesienia nie jestzerowy.

    Uwaga rozszerzalny interfejs przełącznika może odłączyć fizyczne połączenie karty sieciowej, podczas gdy jego licznik odniesienia jest niezerowy. Aby uzyskać więcej informacji, zobacz Hyper-V Extensible Switch Port and Network Adapter States.

  2. Rozszerzenie hermetyzuje żądanie OID, inicjując strukturę NDIS_SWITCH_NIC_OID_REQUEST w następujący sposób:

    • Element członkowski DestinationPortId musi być ustawiony na identyfikator rozszerzalnego portu przełącznika, z którym jest podłączona zewnętrzna karta sieciowa.

    • Element członkowski DestinationNicIndex musi być ustawiony na wartość indeksu innego niżzerowa podstawowej fizycznej karty sieciowej.

    • Jeśli rozszerzenie pochodzi w imieniu partycji podrzędnej Hyper-V, SourcePortId i elementy członkowskie SourceNicIndex są ustawione na odpowiednie wartości dla portu i karty sieciowej używanej przez partycję. W przeciwnym razie składowe SourcePortId i SourceNicIndex są ustawione na zero.

      Jeśli na przykład rozszerzenie zarządza zasobami odciążania sprzętu dla partycji podrzędnej, musi ustawić SourcePortId i sourceNicIndex składowych, aby określić partycję, dla której jest hermetyzowane żądanie odciążania sprzętu.

    • Element członkowski OidRequest musi być ustawiony na wskaźnik na zainicjowaną strukturę NDIS_OID_REQUEST dla hermetyzowanego żądania identyfikatora OID.

  3. Rozszerzenie wywołuje NdisFOidRequest, aby przekazać żądanie OID do określonego portu rozszerzalnego przełącznika i karty sieciowej.

  4. Gdy usługa NDIS wywołuje funkcję FilterOidRequestComplete, rozszerzenie wywołuje DereferenceSwitchNic w celu wyczyszczenia licznika odwołania dla indeksu docelowej fizycznej karty sieciowej.

Kody stanu powrotu

Podstawowa krawędź miniportu przełącznika rozszerzalnego kończy żądanie zapytania OID OID_SWITCH_NIC_REQUEST i zwraca jeden z następujących kodów stanu.

Kod stanu Opis

NDIS_STATUS_SUCCESS

Żądanie OID zostało ukończone pomyślnie.

NDIS_STATUS_Xxx

Żądanie nie powiodło się z innych powodów.

Wymagania

Wersja

Obsługiwane w usłudze NDIS 6.30 i nowszych wersjach.

Nagłówek

 Ntddndis.h (m.in. Ndis.h)

Zobacz też

NDIS_STATUS_INDICATION

NDIS_SWITCH_NIC_OID_REQUEST