OID_NIC_SWITCH_CREATE_VPORT
Nadmierny sterownik wystawia żądanie metody identyfikatora obiektu (OID) OID_NIC_SWITCH_CREATE_VPORT w celu utworzenia niezdefinicyjnego portu wirtualnego (VPort) na przełączniku karty sieciowej karty sieciowej. To żądanie metody OID dołącza również utworzone VPort do funkcji fizycznej PCI Express (PCIe) karty sieciowej (PF) lub wcześniej przydzielonej funkcji wirtualnej PCIe (VF).
Nadmierne sterowniki wystawiają to żądanie metody OID do sterownika miniportu dla pf karty sieciowej. To żądanie metody identyfikatora OID jest 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.
Uwagi
Nadmierny sterownik inicjuje strukturę NDIS_NIC_SWITCH_VPORT_PARAMETERS z informacjami o konfiguracji, które mają zostać utworzone w ramach niezdefinicyjnego programu VPort. Informacje o konfiguracji obejmują funkcję PCIe, do której jest dołączony nondefault VPort, oraz liczba par kolejek dla niedefault VPort.
Gdy sterownik miniportu PF jest wystawiony żądanie OID, sterownik przydziela zasoby sprzętowe i programowe skojarzone z określonym niedefault VPort. Po pomyślnym przydzieleniu wszystkich zasobów sterownik miniport PF pomyślnie ukończy identyfikator OID, zwracając NDIS_STATUS_SUCCESS z MiniportOidRequest.
Jeśli żądanie OID_NIC_SWITCH_CREATE_VPORT zakończy się pomyślnie, sterownik miniportu PF i sterownik nadmiarowy musi zachować VPortId wartość nondefault VPort dla kolejnych operacji. Wartość VPortId jest używana podczas tych operacji:
NDIS i nadmierne sterowniki używają wartości VPortId, aby zidentyfikować niezdefault VPort w kolejnych żądaniach OID związanych z tym VPort, takich jak OID_NIC_SWITCH_VPORT_PARAMETERS i OID_NIC_SWITCH_DELETE_VPORT.
Podczas operacji wysyłania NDIS określa wartość VPortId, aby zidentyfikować port VPort, z którego wysłano pakiet. Ta wartość jest określana w obrębie danych poza pasmem (OOB) NDIS_NET_BUFFER_LIST_FILTERING_INFO struktury NET_BUFFER_LIST.
Podczas operacji odbierania sterownik miniportu PF określa VPortId wartość, do której ma być przekazywany pakiet. Ta wartość jest również określona w danych OOB NDIS_NET_BUFFER_LIST_FILTERING_INFO struktury NET_BUFFER_LIST.
Aby uzyskać więcej informacji, zobacz Tworzenie portu wirtualnego.
Uwaga Domyślny port VPort zawsze istnieje i nie jest tworzony, choć żądanie OID OID_NIC_SWITCH_CREATE_VPORT. Domyślny port VPort ma identyfikator NDIS_DEFAULT_VPORT_ID. Gdy sterownik miniportu PF tworzy przełącznik karty sieciowej, sterownik automatycznie dołącza domyślne VPort do pf karty sieciowej.
Kody stanu powrotu
Sterownik NDIS lub miniport PF zwraca jeden z następujących kodów stanu dla żądania metody OID OID_NIC_SWITCH_CREATE_SWITCH.
| Kod stanu | Opis |
|---|---|
NDIS_STATUS_SUCCESS |
Żądanie OID zostało ukończone pomyślnie. |
NDIS_STATUS_NOT_SUPPORTED |
Sterownik miniportu PF nie obsługuje interfejsu 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 |
Długość buforu informacji jest mniejsza niż sizeof(NDIS_NIC_SWITCH_VPORT_PARAMETERS). Sterownik miniportu PF musi ustawić DANE. METHOD_INFORMATION. BajtyNowe składowe 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) |