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_NIC_CONNECT w celu powiadamiania podstawowych rozszerzalnych rozszerzeń przełączników, że połączenie sieciowe między rozszerzalnym portem przełącznika a kartą sieciową jest całkowicie ustanowione. Krawędź protokołu wcześniej powiadomiła rozszerzenia, że to połączenie jest ustanawiane podczas wystawiania żądania zestawu identyfikatorów OID OID_SWITCH_NIC_CREATE.
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 rozszerzalny port przełącznika, dla którego jest wykonywane powiadomienie o połączeniu. Rozszerzalne rozszerzenie przełącznika może uzyskać informacje o parametrach dla tego portu i innych rozszerzalnych portów przełącznika 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 kartę miniport rozszerzenia.
Sprawdzając różne identyfikatory OID ustawiają żądania OID_SWITCH_PORT_CREATE i OID_SWITCH_PORT_DELETE.
Indeks index elementu członkowskiego struktury NDIS_SWITCH_NIC_PARAMETERS określa indeks karty sieciowej, dla której jest wykonywane powiadomienie o połą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.
Po odebraniu żądania zestawu identyfikatorów OID OID_SWITCH_NIC_CONNECT rozszerzenie musi postępować zgodnie z następującymi wytycznymi:
Po zakończeniu żądania OID_SWITCH_NIC_CONNECT z NDIS_STATUS_SUCCESS połączenie sieciowe i rozszerzalny port przełącznika są w pełni funkcjonalne. Rozszerzenie może generować lub przekazywać ruch pakietów do połączenia sieciowego portu. Rozszerzenie może również wystawiać rozszerzalne identyfikatory operacyjnego przełącznika lub wskazania stanu, które używają portu jako portu źródłowego. Rozszerzenie może również wywołać ReferenceSwitchPort, aby zwiększać rozszerzalny licznik odwołania przełącznika dla portu.
Rozszerzenie nie może modyfikować struktury NDIS_SWITCH_NIC_PARAMETERS skojarzonej z żądaniem OID.
Rozszerzenie musi zawsze wywoływać NdisFOidRequest, aby przekazać to żądanie OID do bazowych rozszerzeń. Rozszerzenie nie może ukończyć samego żądania OID.
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_CONNECT. 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, zobacz wartości indeksu karty sieciowej.
Rozszerzenie musi zachować stan połączenia dla każdej podstawowej karty fizycznej powiązanej z zewnętrzną kartą sieciową. 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_CONNECT.
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_NIC_CONNECT 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) |