Udostępnij za pośrednictwem


OID_SWITCH_NIC_DISCONNECT

Krawędź protokołu Hyper-V rozszerzalnego przełącznika wystawia żądanie zestawu identyfikatora obiektu (OID) OID_SWITCH_NIC_DISCONNECT w celu powiadamiania podstawowych rozszerzalnych rozszerzeń przełączników, że połączenie między rozszerzalnym portem przełącznika a kartą sieciową jest przerywane. Po całkowitym zerwaniu połączenia krawędź protokołu przełącznika rozszerzalnego wyda żądanie zestawu identyfikatorów OID OID_SWITCH_NIC_DELETE.

Element InformationBuffer struktury NDIS_OID_REQUEST zawiera wskaźnik do struktury NDIS_SWITCH_NIC_PARAMETERS.

Uwagi

Index składowej struktury NDIS_SWITCH_NIC_PARAMETERS określa indeks karty sieciowej, dla której jest wykonywane powiadomienie o rozłączeniu. Karta sieciowa z określoną wartością Index jest połączona z rozszerzalnym portem przełącznika określonym przez element członkowski portid. Aby uzyskać więcej informacji na temat tych wartości indeksu, zobacz Wartości indeksu karty sieciowej.

Rozszerzenie musi postępować zgodnie z tymi wytycznymi, gdy obsługuje żądania zestawów OID OID_SWITCH_NIC_DISCONNECT:

  • Rozszerzenie nie może modyfikować struktury NDIS_SWITCH_NIC_PARAMETERS skojarzonej z żądaniem OID.

  • Żądanie OID_SWITCH_NIC_DISCONNECT powiadamia tylko rozszerzenie, że rozszerzalne połączenie przełącznika jest przerywane między określoną kartą sieciową a rozszerzalnym portem przełącznika. Gdy rozszerzenie obsługuje to żądanie OID, nie może wykonać następujących czynności:

    • Wygeneruj dowolny ruch pakietów do połączenia karty sieciowej na rozszerzalnym porcie przełącznika, dla którego wydano żądanie OID_SWITCH_NIC_DISCONNECT OID.

    • Wywołaj ReferenceSwitchNic, aby zwiększać rozszerzalny licznik odwołania przełącznika dla określonego połączenia karty sieciowej na rozszerzalnym porcie przełącznika.

    • Przesyłaj dalej lub pochodzą żądania identyfikatora OID OID_SWITCH_NIC_REQUEST do podstawowej karty sieciowej, dla której wydano żądanie identyfikatora OID OID_SWITCH_NIC_DISCONNECT.

      Uwaga Jeśli rozszerzenie o nazwie ReferenceSwitchNic, aby zwiększać rozszerzalny licznik odwołań przełącznika przed wydaniem OID_SWITCH_NIC_DISCONNECT, rozszerzenie może nadal przesyłać dalej lub pochodzić żądania OID.

    • Prześlij dalej lub pochodzą wskazania stanu NDIS NDIS_STATUS_SWITCH_NIC_STATUS z podstawowej karty sieciowej, dla której wydano żądanie identyfikatora OID OID_SWITCH_NIC_DISCONNECT.

      Uwaga Jeśli rozszerzenie o nazwie ReferenceSwitchNic zwiększać rozszerzalny licznik odwołań przełącznika przed wydaniem OID_SWITCH_NIC_DISCONNECT, rozszerzenie może nadal przesyłać dalej lub pochodzić ze wskazania stanu NDIS.

      Uwaga Jeśli rozszerzenie wcześniej o nazwie ReferenceSwitchNic, aby zwiększać rozszerzalny licznik odwołań przełącznika, nie musi synchronizować wywołań pochodzących lub przekazywać dalej żądań OID lub wskazówek stanu NDIS z kodem, który zarządza Hyper-V rozszerzalnych żądań OID przełącznika. Po rozszerzeniu zwiększa licznik odwołania, rozszerzalny interfejs przełącznika nie będzie wystawiać żądania zestawu identyfikatorów OID OID_SWITCH_NIC_DELETE.

  • Rozszerzenie musi zawsze przesyłać dalej to żądanie zestawu identyfikatorów OID do bazowych rozszerzeń. Rozszerzenie nie może ukończyć żądania.

  • Rozszerzalna zewnętrzna karta sieciowa przełącznika może wiązać się z co najmniej jedną podstawową kartą fizyczną. Dla każdej fizycznej karty sieciowej powiązanej z zewnętrzną kartą sieciową krawędź protokołu przełącznika rozszerzalnego wystawia oddzielne żądanie zestawu identyfikatorów OID OID_SWITCH_NIC_DISCONNECT. Każde żądanie zestawu identyfikatorów OID określa inną wartość indeksu połączenia karty sieciowej. Aby uzyskać więcej informacji na temat tych wartości indeksu, zobacz Wartości indeksu karty sieciowej.

    Rozszerzenie musi zachować stan połączenia dla każdej podstawowej karty fizycznej. Aby uzyskać więcej informacji na temat różnych konfiguracji, w których fizyczne karty sieciowe mogą być powiązane z zewnętrzną kartą sieciową, zobacz Typy konfiguracji fizycznej karty sieciowej.

Uwaga Rozszerzenie nie może wystawiać własnych żądań zestawów OID OID_SWITCH_NIC_DISCONNECT.

Aby uzyskać więcej informacji na temat stanów rozszerzalnych portów przełącznika i połączeń kart sieciowych, zobacz Hyper-V Extensible Switch Port and Network Adapter States.

Kody stanu powrotu

Podstawowa krawędź miniportu przełącznika rozszerzalnego kończy żądanie zapytania OID OID_SWITCH_NIC_DISCONNECT i zwraca następujący kod stanu.

Kod stanu Opis

NDIS_STATUS_SUCCESS

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

Wymagania

Wersja

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

Nagłówek

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

Zobacz też


NDIS_OID_REQUEST

NDIS_SWITCH_NIC_PARAMETERS

OID_SWITCH_NIC_DELETE

OID_SWITCH_PORT_ARRAY

ReferenceSwitchPort