OID_SWITCH_PORT_DELETE

Artykuł
03/13/2025

Krawędź protokołu Hyper-V rozszerzalnego przełącznika wystawia żądanie zestawu identyfikatora obiektu (OID) OID_SWITCH_PORT_DELETE powiadamiania rozszerzalnych rozszerzeń przełącznika o usunięciu rozszerzalnego portu przełącznika.

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

Uwagi

Element PortId struktury NDIS_SWITCH_PORT_PARAMETERS określa rozszerzalny port przełącznika, dla którego jest wykonywane powiadomienie o usunięciu.

Jeśli karta sieciowa jest podłączona do określonego portu, krawędź protokołu przełącznika rozszerzalnego usunie połączenie przed usunięciem portu. W takim przypadku krawędź protokołu wykona następujące kroki przed usunięciem portu:

Krawędź protokołu wysyła żądanie zestawu identyfikatorów OID OID_SWITCH_NIC_DISCONNECT, aby powiadomić rozszerzenie, że połączenie między kartą sieciową a rozszerzalnym portem przełącznika jest usuwane.
Po anulowaniu lub zakończeniu wszystkich oczekujących pakietów dla określonego rozszerzonego portu przełącznika, brzeg protokołu wystawia żądanie zestawu identyfikatorów OID OID_SWITCH_NIC_DELETE, aby powiadomić rozszerzenie o usunięciu połączenia między kartą sieciową a rozszerzalnym portem przełącznika.

W tym momencie krawędź protokołu może zacząć usuwać port.

Krawędź protokołu przełącznika rozszerzalnego jest zgodna z tymi krokami po usunięciu rozszerzalnego portu przełącznika:

Krawędź protokołu przełącznika rozszerzalnego wystawia żądanie zestawu identyfikatorów OID OID_SWITCH_PORT_TEARDOWN. To żądanie identyfikatora OID powiadamia podstawowe rozszerzenia rozszerzalnych przełączników o rozpoczęciu procesu usuwania dla rozszerzalnego portu przełącznika.
Brzeg protokołu wystawia żądanie zestawu identyfikatorów OID OID_SWITCH_PORT_DELETE po zakończeniu wszystkich żądań OID do rozszerzalnego portu przełącznika.

Uwaga Jeśli rozszerzenie wcześniej o nazwie ReferenceSwitchPort w celu inkrementacji licznika odwołania portu, musi wywołać DereferenceSwitchPort, zanim brzeg protokołu wystawia żądanie OID_SWITCH_NIC_DELETE.

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

Rozszerzenie nie może modyfikować struktury NDIS_SWITCH_PORT_PARAMETERS skojarzonej z żądaniem OID.
Rozszerzenie musi zawsze przesyłać dalej to żądanie zestawu identyfikatorów OID do bazowych rozszerzeń. Rozszerzenie nie może zakończyć się niepowodzeniem żądania.
Po zakończeniu żądania OID_SWITCH_PORT_DELETE z NDIS_STATUS_SUCCESS rozszerzenie nie otrzyma żadnych pakietów ani żądań OID dla usuniętego portu. Rozszerzenie nie może przekazywać pakietów do usuniętego portu. Rozszerzenie nie może również wystawiać żądań OID ani wywołać funkcji ReferenceSwitchPort dla usuniętego portu.

Uwaga rozszerzenia przełącznika rozszerzalnego nie mogą wystawiać żądań zestawów OID OID_SWITCH_PORT_DELETE.

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 zestawu identyfikatorów OID OID_SWITCH_PORT_DELETE i zwraca następujący kod stanu.