Sdílet prostřednictvím


OID_SRIOV_SET_VF_POWER_STATE

Přílišný ovladač vydává požadavek na nastavení identifikátoru objektu (OID) OID_SRIOV_SET_VF_POWER_STATE ke změně stavu napájení zadané virtuální funkce PCI Express (PCIe) na síťovém adaptéru. Vzhledem k tomu, že změna stavu napájení je privilegovaná operace, příliš velké ovladače vydávají tento požadavek sady identifikátorů na ovladač miniportu fyzické funkce PCIe (PF) na síťovém adaptéru. Ovladač miniportu PF pak nastaví zadaný stav napájení ve VF.

InformationBuffer člen struktury NDIS_OID_REQUEST obsahuje ukazatel na NDIS_SRIOV_SET_VF_POWER_STATE_PARAMETERS strukturu.

Poznámky

Pokud je ovladač miniportu PF vystaven tento požadavek sady identifikátorů, musí postupovat podle těchto pokynů:

  • Ovladač miniportu PF musí ověřit, že VF určený VFId člen struktury NDIS_SRIOV_SET_VF_POWER_STATE_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 zadaný VF není v přiděleném stavu, ovladač musí požadavek OID selhat.

  • Operace stavu napájení 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 naleznete v tématu Nastavení stavu napájení virtuální funkce.

Návratové stavové kódy

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

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_SET_VF_POWER_STATE_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_SET_VF_POWER_STATE_PARAMETERS

OID_NIC_SWITCH_ALLOCATE_VF