OID_NIC_SWITCH_DELETE_SWITCH

Artykuł
03/13/2025

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.