Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Krawędź protokołu Hyper-V rozszerzalnego przełącznika wystawia żądanie zestawu identyfikatora obiektu (OID) OID_SWITCH_PORT_TEARDOWN w celu powiadomienia rozszerzalnych rozszerzeń przełączników, że rozszerzalny port przełącznika rozpocznie proces usuwania. Ten proces jest uruchamiany, gdy sterownik protokołu wysyła żądanie zestawu identyfikatorów OID OID_SWITCH_PORT_DELETE.
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 połączeniu. Rozszerzenie rozszerzalnego przełącznika musi zaktualizować wszystkie buforowane informacje o porcie uzyskanym w następujący sposób:
Wysyłając żądania zapytań OID OID_SWITCH_PORT_ARRAY. Rozszerzenie wystawia ten identyfikator OID w FilterAttach tylko wtedy, gdy OID_SWITCH_PARAMETERS zwraca strukturę NDIS_SWITCH_PARAMETERS z IsActive ustawioną na true. Jeśli IsActive ma wartość FALSE, rozszerzenie wystawia OID, gdy NetEventSwitchActivateNET_PNP_EVENT jest wystawiany przez miniport rozszerzenia.
Sprawdzając różne identyfikatory OID ustawiają żądania OID_SWITCH_PORT_CREATE i OID_SWITCH_PORT_DELETE.
Krawędź protokołu rozszerzalnego przełącznika wystawia żądanie zestawu identyfikatorów OID OID_SWITCH_PORT_TEARDOWN, aby powiadomić rozszerzenie, że port jest w trakcie usuwania z rozszerzalnego przełącznika. Przed wydaniem tego żądania identyfikatora OID krawędź protokołu przełącznika rozszerzalnego wydała wcześniej następujące identyfikatory OID, jeśli port miał aktywne połączenie karty sieciowej:
OID_SWITCH_NIC_DISCONNECT, które powiadomiły podstawowe rozszerzenia, że karta sieciowa nie jest już połączona z portem określonym w strukturze NDIS_SWITCH_PORT_PARAMETERS.
OID_SWITCH_NIC_DELETE, które powiadomiły podstawowe rozszerzenia o usunięciu połączenia sieciowego między kartą sieciową a rozszerzalnym portem przełącznika.
Krawędź protokołu wystawia to żądanie zestawu identyfikatorów OID po anulowaniu lub zakończeniu wszystkich oczekujących pakietów dla określonego rozszerzalnego portu przełącznika.
Po zakończeniu tego żądania zestawu identyfikatorów OID i licznik odwołania dla rozszerzalnego portu przełącznika wynosi zero, krawędź protokołu rozszerzalnego przełącznika wystawia żądanie zestawu identyfikatorów OID OID_SWITCH_PORT_DELETE. To żądanie identyfikatora OID usuwa port z rozszerzalnego przełącznika.
Uwaga Rozszerzenie zwiększa licznik odwołania dla rozszerzalnego portu przełącznika przez wywołanie ReferenceSwitchPort. Rozszerzenie dekrementuje licznik odwołań przez wywołanie DereferenceSwitchPort.
Rozszerzenie musi postępować zgodnie z tymi wytycznymi dotyczącymi obsługi żądań zestawów OID OID_SWITCH_PORT_TEARDOWN:
Rozszerzenie musi zawsze przesyłać dalej to żądanie zestawu identyfikatorów OID do bazowych rozszerzeń. Rozszerzenie nie może zakończyć się niepowodzeniem żądania.
Uwaga Rozszerzenie nie może modyfikować struktury NDIS_SWITCH_PORT_PARAMETERS skojarzonej z żądaniem OID.
Po przesłaniu dalej tego żądania OID rozszerzenie nie może przekazać 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 Rozszerzenie nie może wystawiać żądań zestawów OID OID_SWITCH_PORT_TEARDOWN.
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_TEARDOWN 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) |