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.
Usługa NDIS wystawia żądanie metody identyfikatora obiektu (OID) OID_NIC_SWITCH_CREATE_SWITCH w celu utworzenia przełącznika karty sieciowej na karcie sieciowej. Gdy obsługuje to żądanie OID, sterownik miniportu przydziela zasoby dla przełącznika karty sieciowej na karcie.
Usługa NDIS wysyła żądanie tej metody OID do sterownika miniportu funkcji fizycznej (PF) karty sieciowej PCI Express (PCIe). 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).
Uwaga overlying sterowników, takich jak sterowniki protokołu lub filtru, nie może wydać żądania metody OID OID_NIC_SWITCH_CREATE_SWITCH do sterownika miniport PF.
Element InformationBuffer struktury NDIS_OID_REQUEST zawiera wskaźnik do struktury NDIS_NIC_SWITCH_PARAMETERS.
Uwagi
Gdy odbiera żądanie metody OID OID_NIC_SWITCH_CREATE_SWITCH, sterownik miniportu PF musi wykonać następujące czynności:
Jeśli sterownik miniportu PF obsługuje tworzenie i konfigurację przełącznika statycznego, tworzy przełącznik karty sieciowej, gdy usługa NDIS wywołuje MiniportInitializeEx. Gdy sterownik obsługuje to żądanie OID, musi zweryfikować parametry konfiguracji w strukturze NDIS_NIC_SWITCH_PARAMETERS. Parametry muszą być takie same jak parametry używane przez sterownik, aby utworzyć przełącznik podczas wywołania polecenia MiniportInitializeEx. Jeśli tak nie jest, sterownik musi zakończyć się niepowodzeniem żądania identyfikatora OID.
Aby uzyskać więcej informacji, zobacz Statyczne tworzenie przełącznika karty sieciowej.
Jeśli sterownik miniportu PF obsługuje tworzenie i konfigurację przełącznika dynamicznego, sterownik musi zweryfikować wartości konfiguracji struktury NDIS_NIC_SWITCH_PARAMETERS i utworzyć przełącznik karty sieciowej na podstawie tych wartości.
Aby uzyskać więcej informacji, zobacz dynamiczne tworzenie przełącznika kart interfejsu sieciowego.
Sterownik miniportu PF musi przydzielić niezbędne zasoby sprzętowe i programowe dla domyślnego wirtualnegoportu na przełączniku karty sieciowej.
Uwaga Domyślny port VPort jest zawsze tworzony za pośrednictwem żądania identyfikatora OID OID_NIC_SWITCH_CREATE_SWITCH i usunięty za pośrednictwem żądania identyfikatora OID OID_NIC_SWITCH_DELETE_SWITCH. Żądania OID OID_NIC_SWITCH_CREATE_VPORT i OID_NIC_SWITCH_DELETE_VPORT są używane do tworzenia i usuwania niezdefinicyjnych portów wirtualnych na przełączniku karty sieciowej.
Sterownik miniportu PF obsługujący tworzenie i konfigurację przełącznika dynamicznego musi włączyć wirtualizację SR-IOV na przełączniku przez wywołanie NdisMEnableVirtualization. To wywołanie konfiguruje element członkowski NumVFs i VF Włącz bit w strukturze SR-IOV rozszerzonej możliwości przestrzeni konfiguracji PCI Express (PCIe) karty.
Aby uzyskać więcej informacji na temat przestrzeni konfiguracji SR-IOV, zobacz specyfikację PCI-SIG Wirtualizacja we/wy pojedynczego katalogu głównego i udostępnianie 1.1.
Uwaga Jeśli sterownik miniportu PF obsługuje tworzenie przełącznika statycznego, włącza wirtualizację SR-IOV po utworzeniu przełącznika po wywołaniu MiniportInitializeEx.
Jeśli sterownik miniportu PF pomyślnie ukończy żądanie metody OID OID_NIC_SWITCH_CREATE_SWITCH, umożliwia wykonanie następujących czynności:
VFs można przydzielić na przełączniku karty sieciowej za pośrednictwem żądań metody OID OID_NIC_SWITCH_ALLOCATE_VF.
Niezdefault VPorts można utworzyć na karcie sieciowej przełącznika przez żądania metody OID OID_NIC_SWITCH_CREATE_VPORT.
Aby uzyskać więcej informacji na temat obsługi tego żądania OID, zobacz Obsługa żądania OID_NIC_SWITCH_CREATE_SWITCH.
Kody stanu powrotu
Sterownik miniportu 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_PARAMETERS ma nieprawidłowe wartości. |
NDIS_STATUS_INVALID_LENGTH |
Długość buforu informacji jest mniejsza niż sizeof(NDIS_NIC_SWITCH_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) |