OID_NIC_SWITCH_DELETE_SWITCH
Usługa NDIS wystawia żądanie zestawu identyfikatora obiektu (OID) OID_NIC_SWITCH_DELETE_SWITCH w celu usunięcia przełącznika karty sieciowej z karty sieciowej.
Usługa NDIS wystawia to żądanie zestawu identyfikatorów OID do sterownika miniportu funkcji fizycznej (PF) karty sieciowej PCI Express (PCIe). To żądanie zestawu identyfikatorów OID jest wymagane dla sterowników miniportu PF, które obsługują interfejs wirtualizacji we/wy pojedynczego głównego (SR-IOV).
Uwaga nadmierne sterowniki, takie jak sterowniki protokołu lub filtru, nie mogą wydać tego żądania metody OID do sterownika miniport PF.
Element InformationBuffer struktury NDIS_OID_REQUEST zawiera wskaźnik do struktury NDIS_NIC_SWITCH_DELETE_SWITCH_PARAMETERS.
Uwagi
Żądanie zestawu identyfikatorów OID OID_NIC_SWITCH_DELETE_SWITCH usuwa przełącznik karty sieciowej, który został wcześniej utworzony za pomocą żądania metody OID OID_NIC_SWITCH_CREATE_SWITCH.
Gdy odbiera żądanie metody OID OID_NIC_SWITCH_DELETE_SWITCH, sterownik miniportu PF musi wykonać następujące czynności:
Jeśli sterownik miniportu PF obsługuje statyczne tworzenie i konfigurację przełączników kart interfejsu sieciowego, musi zwolnić zasoby oprogramowania skojarzone z określonym przełącznikiem karty sieciowej. Sterownik może jednak zwolnić zasoby sprzętowe przełącznika karty sieciowej tylko wtedy, gdy wywoływana jest MiniportHaltEx.
Aby uzyskać więcej informacji na temat tworzenia statycznego przełącznika karty sieciowej, zobacz statyczne tworzenie przełącznika karty sieciowej.
Jeśli sterownik miniportu PF obsługuje dynamiczne tworzenie i konfigurację przełączników kart interfejsu sieciowego, musi zwolnić zasoby sprzętowe i programowe skojarzone z określonym przełącznikiem karty sieciowej.
Aby uzyskać więcej informacji na temat dynamicznego tworzenia przełącznika karty sieciowej, zobacz tworzenie dynamicznego przełącznika kart interfejsu sieciowego.
Jeśli sterownik miniportu PF obsługuje tworzenie dynamiczne i wszystkie przełączniki kart interfejsu sieciowego zostały usunięte, sterownik musi wyłączyć wirtualizację na karcie, wywołując NdisMEnableVirtualization. Aby wyłączyć wirtualizację, karta sieciowa musi ustawić parametr EnableVirtualization na FALSE, a parametr NumVFs na zero.
NdisMEnableVirtualization czyści element członkowski NumVFs i VF Enable bit w strukturze SR-IOV Extended Capability w przestrzeni konfiguracji PCI karty sieciowej PF.
Uwaga Jeśli sterownik miniportu PF obsługuje statyczne tworzenie i konfigurację przełączników karty sieciowej, musi wywołać tylko NdisMEnableVirtualization po wywołaniu MiniportHaltEx.
Aby uzyskać więcej informacji, zobacz Usuwanie przełącznika karty sieciowej.
Kody stanu powrotu
Funkcjaminiportu sterownikaMiniportOidRequest zwraca jedną z następujących wartości dla tego żądania:
Termin | Opis |
---|---|
NDIS_STATUS_SUCCESS |
Sterownik miniportu zakończył żądanie pomyślnie. |
NDIS_STATUS_PENDING |
Sterownik miniportu zakończy żądanie asynchronicznie. Po zakończeniu całego przetwarzania przez sterownik miniportu żądanie musi zakończyć się powodzeniem przez wywołanie funkcji NdisMOidRequestComplete, przekazując NDIS_STATUS_SUCCESS dla parametru stanu. |
NDIS_STATUS_NOT_ACCEPTED |
Sterownik miniportu resetuje się. |
NDIS_STATUS_REQUEST_ABORTED |
Sterownik miniportu przestał przetwarzać żądanie. Na przykład NDIS nosi nazwę funkcji MiniportResetEx. |
Usługa NDIS zwraca jeden z następujących kodów stanu dla tego żądania:
Termin | 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_FILE_NOT_FOUND |
Co najmniej jeden z elementów członkowskich struktury NDIS_NIC_SWITCH_DELETE_SWITCH_PARAMETERS ma nieprawidłowe wartości. |
NDIS_STATUS_INVALID_LENGTH |
Bufor informacyjny jest za mały. Usługa NDIS ustawia DATA. SET_INFORMATION. BajtyNowe składowe w strukturze NDIS_OID_REQUEST do minimalnego wymaganego rozmiaru buforu. |
Wymagania
Wersja |
Obsługiwane w usłudze NDIS 6.30 i nowszych wersjach. |
Nagłówek |
Ntddndis.h (m.in. Ndis.h) |