Sdílet prostřednictvím


OID_SRIOV_RESET_VF

Nadměrné ovladače vydávají požadavek na nastavení identifikátoru objektu (OID) OID_SRIOV_RESET_VF k resetování zadané virtuální funkce PCI Express (PCIe) na síťovém adaptéru, který podporuje virtualizaci vstupně-výstupních operací s jedním kořenovým rozhraním. Overlying drivers issue this OID set request to the miniport driver of the PCI Express (PCIe) Physical Function (PF) of the network adapter.

InformationBuffer člen struktury NDIS_OID_REQUEST obsahuje ukazatel na NDIS_SRIOV_RESET_VF_PARAMETERS strukturu. Přílišný ovladač určuje identifikátor VF, který se má resetovat prostřednictvím VFId člena této struktury.

Poznámky

VF je možné resetovat prostřednictvím resetování na úrovni funkce PCI Express (PCIe). Vzhledem k tomu, že požadavek FLR je privilegovaná operace, může ji provést pouze ovladač miniportu PF, který běží v operačním systému správy Hyper-V nadřazeného oddílu. Přílišné ovladače, které běží v operačním systému pro správu, jsou upozorněny na žádost FLR a vydat požadavek sady identifikátorů OID_SRIOV_RESET_VF ovladači PF miniport.

Při zpracování tohoto požadavku OID musí ovladač miniportu PF postupovat podle těchto pokynů:

  • Ovladač miniportu PF musí ověřit, že VF určený VFId člen struktury NDIS_SRIOV_RESET_VF_PARAMETERS má prostředky, které byly dříve přiděleny. Ovladač miniportu PF přiděluje prostředky pro VF během požadavku metody OID OID_NIC_SWITCH_ALLOCATE_VF. Pokud nebyly přiděleny prostředky pro zadaný VF, ovladač musí požadavek OID selhat.

  • Operace resetování musí mít vliv pouze na zadaný VF. Operace nesmí mít vliv na jiné soubory VFS nebo PF na stejném síťovém adaptéru.

Další informace najdete v tématu Resetování virtuálníhofunkce .

Návratové stavové kódy

Ovladač miniportu PF vrátí jeden z následujících stavových kódů pro nastavený požadavek OID_SRIOV_RESET_VF.

Stavový kód Popis

NDIS_STATUS_SUCCESS

Požadavek OID byl úspěšně dokončen.

NDIS_STATUS_NOT_SUPPORTED

Ovladač miniportu PF buď nepodporuje rozhraní jedno kořenové virtualizace vstupně-výstupních operací (SR-IOV), nebo není povoleno používat rozhraní.

NDIS_STATUS_INVALID_PARAMETER

Nejméně jeden člen struktury NDIS_SRIOV_RESET_VF_PARAMETERS má neplatné hodnoty.

NDIS_STATUS_INVALID_LENGTH

Informační vyrovnávací paměť byla příliš krátká. Ovladač miniportu PF musí nastavit DATA. SET_INFORMATION. BytesNeeded člen ve struktuře NDIS_OID_REQUEST na minimální požadovanou velikost vyrovnávací paměti.

NDIS_STATUS_FAILURE

Žádost se nezdařila z jiných důvodů.

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_OID_REQUEST

NDIS_SRIOV_RESET_VF_PARAMETERS

OID_NIC_SWITCH_ALLOCATE_VF