OID_SRIOV_SET_VF_POWER_STATE

  • 發行項

過度配置驅動程式會發出物件識別碼 (OID) 組 OID_SRIOV_SET_VF_POWER_STATE要求，以變更網路介面卡上指定 PCI Express (PCIe) Virtual Function (VF) 的電源狀態。 由於變更電源狀態是特殊許可權作業，因此過度配置驅動程式會將此 OID 設定要求發出給網路介面卡上 PCIe 實體函式的迷你埠驅動程式 (PF) 。 PF 迷你埠驅動程式接著會在 VF 上設定指定的電源狀態。

NDIS_OID_REQUEST結構的InformationBuffer成員包含NDIS_SRIOV_SET_VF_POWER_STATE_PARAMETERS結構的指標。

備註

發出此 OID 集合要求時，PF 迷你埠驅動程式必須遵循下列指導方針：

  • PF 迷你埠驅動程式必須確認由NDIS_SRIOV_SET_VF_POWER_STATE_PARAMETERS結構的VFId 成員指定的 VF，具有先前配置的資源。 PF 迷你埠驅動程式會在 OID 方法要求 OID_NIC_SWITCH_ALLOCATE_VF期間，為 VF 配置資源。 如果指定的 VF 不是處於配置狀態，驅動程式必須失敗 OID 要求。

  • 電源狀態作業只能影響指定的 VF。 作業不得影響相同網路介面卡上的其他 VFs 或 PF。

如需詳細資訊，請參閱 設定虛擬函式的電源狀態。

傳回狀態碼

PF 迷你埠驅動程式會針對 OID_SRIOV_SET_VF_POWER_STATE 的 OID 集合要求，傳回下列其中一個狀態碼。

狀態碼 描述

NDIS_STATUS_SUCCESS

OID 要求已成功完成。

NDIS_STATUS_NOT_SUPPORTED

PF 迷你埠驅動程式不支援單一根目錄 I/O 虛擬化 (SR-IOV) 介面，或未啟用介面。

NDIS_STATUS_INVALID_PARAMETER

NDIS_SRIOV_SET_VF_POWER_STATE_PARAMETERS結構的一或多個成員具有不正確值。

NDIS_STATUS_INVALID_LENGTH

資訊緩衝區太短。 PF 迷你埠驅動程式必須設定DATA。SET_INFORMATION。NDIS_OID_REQUEST 結構中的 BytesNeeded成員，以達到所需的最小緩衝區大小。

NDIS_STATUS_FAILURE

要求因其他原因而失敗。

規格需求

版本

NDIS 6.30 和更新版本支援。

標頭

 Ntddndis.h (包括 Ndis.h)

另請參閱

NDIS_OID_REQUEST

NDIS_SRIOV_SET_VF_POWER_STATE_PARAMETERS

OID_NIC_SWITCH_ALLOCATE_VF