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) |