OID_NIC_SWITCH_FREE_VF

Nadlimitní ovladač vydává požadavek sady identifikátorů objektů (OID) na OID_NIC_SWITCH_FREE_VF uvolnit prostředky pro virtuální funkci PCI Express (PCIe) síťového adaptéru (VF).

Overlying drivers issue this OID set request to the miniport driver for the network adapter's PCIe Physical Function (PF). Tento požadavek sady identifikátorů je vyžadován pro ovladače miniportu PF, které podporují rozhraní virtualizace V/V s jedním kořenovým serverem (SR-IOV).

InformationBuffer člen struktury NDIS_OID_REQUEST obsahuje ukazatel na NDIS_NIC_SWITCH_FREE_VF_PARAMETERS strukturu.

Přílišný ovladač určuje identifikátor VF, který má být uvolněn prostřednictvím VFId člen této struktury. Ovladač získal tento identifikátor z dřívějšího požadavku metody OID OID_NIC_SWITCH_ALLOCATE_VF.

Poznámky

Nadlimitní ovladač vydá požadavek sady identifikátorů OID OID_NIC_SWITCH_FREE_VF uvolnit prostředky pro VF. Tyto prostředky byly dříve přiděleny prostřednictvím požadavku metody OID OID_NIC_SWITCH_ALLOCATE_VF.

Další informace o tom, jak uvolnit prostředky VF, naleznete v tématu Uvolnění prostředků pro virtuální funkci.

Poznámka Jakmile nadlimitní ovladač požádá o přidělení prostředků pro VF, je tento ovladač jedinou komponentou, která může požádat o uvolnění prostředků pro stejný VF. Nadlimitní ovladač musí vydat požadavek sady identifikátorů OID_NIC_SWITCH_FREE_VF uvolnit prostředky VF. Než bude možné nadlimitní ovladač zastavit, musí uvolnit prostředky pro každý VF, který byl přidělen žádostí o OID_NIC_SWITCH_ALLOCATE_VF řidiče.

Vrácení stavových kódů

Funkce miniportu MiniportOidRequest vrátí jednu z následujících hodnot pro tento požadavek:

Semestr	Popis
NDIS_STATUS_SUCCESS	Ovladač miniportu žádost úspěšně dokončil.
NDIS_STATUS_PENDING	Ovladač miniportu dokončí požadavek asynchronně. Po dokončení veškerého zpracování ovladače miniportu musí být požadavek úspěšný voláním funkce NdisMOidRequestComplete a předáním NDIS_STATUS_SUCCESS pro parametr Status.
NDIS_STATUS_NOT_ACCEPTED	Ovladač miniportu se resetuje.
NDIS_STATUS_REQUEST_ABORTED	Ovladač miniportu zastavil zpracování požadavku. Například NDIS volal MiniportResetEx funkce.

NDIS vrátí jeden z následujících stavových kódů pro tento požadavek:

Semestr	Popis
NDIS_STATUS_SUCCESS	Požadavek OID byl úspěšně dokončen.
NDIS_STATUS_NOT_SUPPORTED	Ovladač miniportu PF nepodporuje rozhraní SR-IOV nebo není povoleno používat rozhraní.
NDIS_STATUS_FILE_NOT_FOUND	Nejméně jeden člen struktury NDIS_NIC_SWITCH_FREE_VF_PARAMETERS má neplatné hodnoty. Například VFId člen může zadat VF, který nebyl přidělen nebo který obsahuje VPorts, které nebyly odstraněny.
NDIS_STATUS_INVALID_LENGTH	Vyrovnávací paměť informací je příliš malá. Rozhraní NDIS nastaví DATA. SET_INFORMATION. BytesNeeded člen ve struktuře NDIS_OID_REQUEST na minimální požadovanou velikost vyrovnávací paměti.

Požadavky

Verze	Podporováno v NDIS 6.30 a novějších verzích.
Záhlaví	Ntddndis.h (včetně Ndis.h)

Viz také

---

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