Udostępnij przez


OID_NIC_SWITCH_FREE_VF

Nadmierny sterownik wystawia żądanie zestawu identyfikatora obiektu (OID) OID_NIC_SWITCH_FREE_VF w celu zwolnienia zasobów dla funkcji wirtualnej PCI Express (PCIe) karty sieciowej (VF).

Nadmierne sterowniki wydają ten sterownik OID ustawiony na miniport sterownika dla funkcji fizycznej PCIe karty sieciowej (PF). 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).

Element członkowski InformationBuffer struktury NDIS_OID_REQUEST zawiera wskaźnik do struktury NDIS_NIC_SWITCH_FREE_VF_PARAMETERS.

Nadmierny sterownik określa identyfikator VF do zwolnienia za pośrednictwem VFId elementu członkowskiego tej struktury. Sterownik uzyskał ten identyfikator z wcześniejszego żądania metody OID OID_NIC_SWITCH_ALLOCATE_VF.

Uwagi

Nadmierny sterownik wystawia żądanie zestawu identyfikatorów OID OID_NIC_SWITCH_FREE_VF w celu zwolnienia zasobów dla VF. Te zasoby zostały wcześniej przydzielone za pośrednictwem żądania metody OID OID_NIC_SWITCH_ALLOCATE_VF.

Aby uzyskać więcej informacji na temat sposobu zwalniania zasobów VF, zobacz Zwalnianie zasobów dla funkcji wirtualnej.

Uwaga Gdy nadmierny sterownik żąda alokacji zasobów dla VF, ten sterownik jest jedynym składnikiem, który może zażądać zwolnienia zasobów dla tego samego VF. Nadmierny sterownik musi wysłać żądanie zestawu identyfikatorów OID OID_NIC_SWITCH_FREE_VF, aby zwolnić zasoby VF. Przed zatrzymaniem nadmiernego sterownika należy zwolnić zasoby dla każdego VF przydzielonego przez żądanie OID_NIC_SWITCH_ALLOCATE_VF kierowcy.

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_FREE_VF_PARAMETERS ma nieprawidłowe wartości. Na przykład element członkowski VFId może określić VF, który nie został przydzielony lub ma dyski VPorts, które nie zostały usunięte.

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)

Zobacz też


NDIS_NIC_SWITCH_FREE_VF_PARAMETERS

NDIS_OID_REQUEST

NdisCloseAdapterEx

OID_NIC_SWITCH_ALLOCATE_VF

OID_NIC_SWITCH_CREATE_VPORT

OID_NIC_SWITCH_DELETE_VPORT

OID_NIC_SWITCH_DELETE_SWITCH