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.
Sterownik overlying może uzyskać parametry dla portu wirtualnego (VPort) na przełączniku karty sieciowej, który został utworzony na karcie sieciowej obsługującej wirtualizację we/wy pojedynczego głównego (SR-IOV). Sterownik wystawia żądanie metody identyfikatora obiektu (OID) OID_NIC_SWITCH_VPORT_PARAMETERS w celu uzyskania tych parametrów.
Nadmierne sterowniki wydają żądanie zestawu identyfikatorów OID OID_NIC_SWITCH_VPORT_PARAMETERS, aby ustawić parametry konfiguracji określonego VPort dołączonego do przełącznika karty sieciowej karty sieciowej. Te żądania zestawu identyfikatorów OID są wydawane do sterownika miniportu funkcji fizycznej (PF) karty sieciowej PCI Express (PCIe). Te żądania zestawu identyfikatorów OID są wymagane dla sterowników miniportu PF, które obsługują interfejs wirtualizacji we/wy pojedynczego głównego (SR-IOV).
Element członkowski InformationBuffer struktury NDIS_OID_REQUEST zawiera wskaźnik do struktury NDIS_NIC_SWITCH_VPORT_PARAMETERS.
Sterownik overlying określa VPort dla metody OID lub ustawić żądanie, ustawiając VPortId elementu członkowskiego struktury NDIS_NIC_SWITCH_VPORT_PARAMETERS do identyfikatora skojarzonego z VPort. Sterownik nadmiernie uzyskuje identyfikator VPort za pomocą jednego z następujących sposobów:
Z poprzedniego żądania metody OID OID_NIC_SWITCH_CREATE_VPORT.
Z poprzedniego żądania metody OID OID_NIC_SWITCH_ENUM_VPORTS.
Uwagi
OID_NIC_SWITCH_VPORT_PARAMETERS można użyć w żądaniach metody OID lub żądań ustawionych przez funkcję OID.
obsługa żądań metod OID OID_NIC_SWITCH_VPORT_PARAMETERS
Nadmierne sterowniki wydają żądanie metody OID OID_NIC_SWITCH_VPORT_PARAMETERS, aby wysłać zapytanie do bieżących parametrów konfiguracji wirtualnegoportu dołączonego do przełącznika karty sieciowej karty sieciowej. Nadmierne określanie sterowników VPort do zapytania przez ustawienie VPortId elementu członkowskiego struktury NDIS_NIC_SWITCH_VPORT_PARAMETERS na identyfikator VPort.
Usługa NDIS obsługuje żądanie metody OID OID_NIC_SWITCH_VPORT_PARAMETERS dla sterowników miniportu. Funkcja NDIS zwraca informacje uzyskane z poprzednich żądań OID OID_NIC_SWITCH_CREATE_VPORT i OID_NIC_SWITCH_ENUM_VPORTS.
Po pomyślnym powrocie z żądania metody OID element członkowski InformationBuffer struktury NDIS_OID_REQUEST zawiera wskaźnik do struktury NDIS_NIC_SWITCH_VPORT_PARAMETERS. Ta struktura zawiera parametry konfiguracji określonego przełącznika.
Aby uzyskać więcej informacji, zobacz Wykonywanie zapytań dotyczących parametrów portu wirtualnego.
obsługa zestawów OID żądań OID_NIC_SWITCH_VPORT_PARAMETERS
Nadmierne sterowniki wydają żądanie zestawu identyfikatorów OID OID_NIC_SWITCH_VPORT_PARAMETERS, aby zmienić bieżące parametry konfiguracji wirtualnegoportu dołączonego do przełącznika karty sieciowej karty sieciowej. To żądanie identyfikatora OID może służyć do aktualizowania parametrów dla parametrów domyślnych, a także niezdefinicyjnych portów wirtualnych.
Można zmienić tylko ograniczony podzestaw parametrów konfiguracji dla wirtualnegoportu. Nadmierny sterownik określa parametr do zmiany, ustawiając następujące elementy członkowskie struktury NDIS_NIC_SWITCH_VPORT_PARAMETERS:
Element członkowski VPortId jest ustawiony na identyfikator VPort, którego parametry zostaną zmienione.
Odpowiednie flagi_CHANGED NDIS_NIC_SWITCH_VPORT_PARAMETERS_Xxx są ustawiane w elemencie Flags. Elementy członkowskie struktury NDIS_NIC_SWITCH_VPORT_PARAMETERS można zmienić tylko wtedy, gdy w ntddndis.h zdefiniowano odpowiednią flagę_CHANGED NDIS_NIC_SWITCH_PARAMETERS_Xxx.
Odpowiednie elementy członkowskie struktury NDIS_NIC_SWITCH_VPORT_PARAMETERS są ustawiane przy użyciu parametrów konfiguracji programu VPort, które mają zostać zmienione.
Po odebraniu przez sterownik miniportu PF żądania zestawu identyfikatora OID OID_NIC_SWITCH_VPORT_PARAMETERS sterownik konfiguruje sprzęt z parametrami konfiguracji. Sterownik może zmienić tylko te parametry konfiguracji identyfikowane przez flagi NDIS_NIC_SWITCH_VPORT_PARAMETERS_Xxx_CHANGED w Flags składowej struktury NDIS_NIC_SWITCH_VPORT_PARAMETERS.
Aby uzyskać więcej informacji, zobacz Ustawianie parametrów portu wirtualnego.
Kody stanu powrotu
Sterownik NDIS lub miniport PF zwraca następujący kod stanu dla żądań OID zestawu lub metody OID_NIC_SWITCH_VPORT_PARAMETERS.
| Kod stanu | Opis |
|---|---|
NDIS_STATUS_SUCCESS |
Żądanie zostało ukończone pomyślnie. InformationBuffer wskazuje strukturę NDIS_NIC_SWITCH_CAPABILITIES. |
NDIS_STATUS_NOT_SUPPORTED |
Sterownik miniportu PF nie obsługuje interfejsu wirtualizacji we/wy pojedynczego katalogu głównego (SR-IOV) lub nie jest włączony do korzystania z interfejsu. |
NDIS_STATUS_INVALID_PARAMETER |
Co najmniej jeden z elementów członkowskich struktury NDIS_NIC_SWITCH_VPORT_PARAMETERS ma nieprawidłowe wartości. |
NDIS_STATUS_INVALID_LENGTH |
Bufor informacyjny był zbyt krótki. Sterownik NDIS lub miniport PF ustawia dane . METHOD_INFORMATION. BytesNeeded member (dla żądań metody OID) lub DATA. SET_INFORMATION. BytesNeeded member (dla żądań zestawu identyfikatorów OID) w strukturze NDIS_OID_REQUEST do minimalnego wymaganego rozmiaru buforu. |
NDIS_STATUS_FAILURE |
Żądanie nie powiodło się z innych powodów. |
Wymagania
Wersja |
Obsługiwane w usłudze NDIS 6.30 i nowszych wersjach. |
Nagłówek |
Ntddndis.h (m.in. Ndis.h) |