Udostępnij przez


OID_SWITCH_NIC_DELETE

Krawędź protokołu Hyper-V rozszerzalnego przełącznika wystawia żądanie zestawu identyfikatora obiektu (OID) OID_SWITCH_NIC_DELETE na rozszerzalny stos sterownika przełącznika. To żądanie identyfikatora OID powiadamia podstawowe rozszerzenia rozszerzalnych przełączników o usunięciu połączenia między rozszerzalnym portem przełącznika a kartą sieciową. Krawędź protokołu rozszerzalnego przełącznika wcześniej powiadomiła rozszerzenia, że to połączenie jest usuwane po wydaniu żądania zestawu identyfikatorów OID OID_SWITCH_NIC_DISCONNECT.

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

Uwagi

Element PortId struktury NDIS_SWITCH_NIC_PARAMETERS określa port, dla którego jest wykonywane powiadomienie o usunięciu. Rozszerzalne rozszerzenie przełącznika może uzyskać informacje o parametrach dla tego i innych portów na rozszerzalnym przełączniku, wydając żądania zapytań OID OID_SWITCH_PORT_ARRAY.

Index element członkowski struktury NDIS_SWITCH_NIC_PARAMETERS określa indeks karty sieciowej, dla której jest wykonywane powiadomienie o usunięciu. 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.

Zanim krawędź protokołu rozszerzalnego przełącznika wyda żądanie OID_SWITCH_NIC_DELETE, gwarantuje, że wszystkie oczekujące żądania wysyłania lub odbierania pakietów dla określonego połączenia karty sieciowej zostały ukończone. Krawędź protokołu gwarantuje również, że wszystkie oczekujące żądania OID dla połączenia karty zostały ukończone, a rozszerzone liczniki odwołania przełącznika dla połączenia karty mają wartość zero.

Uwaga Jeśli rozszerzenie inkrementowało rozszerzalny licznik odwołania przełącznika dla karty sieciowej, wywołując ReferenceSwitchNic, żądanie OID_SWITCH_NIC_DELETE nie jest wystawiane, gdy licznik odwołania jest niezerowy. Rozszerzenie dekrementuje rozszerzalny licznik odwołania przełącznika przez wywołanie DereferenceSwitchNic.

Rozszerzenie musi postępować zgodnie z tymi wytycznymi dotyczącymi obsługi żądań zestawów OID OID_SWITCH_NIC_DELETE:

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

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

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

  • 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_DELETE. 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.

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_DELETE 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ż


DereferenceSwitchNic

NDIS_OID_REQUEST

NDIS_SWITCH_NIC_PARAMETERS

OID_SWITCH_NIC_DISCONNECT

OID_SWITCH_PORT_ARRAY

ReferenceSwitchNic