共用方式為


OID_SRIOV_SET_VF_POWER_STATE

過度配置驅動程式會發出OID_SRIOV_SET_VF_POWER_STATE的物件識別碼 (OID) 集合要求,以變更網路適配器上指定PCI Express (PCIe) 虛擬函式 (VF) 的電源狀態。 由於變更電源狀態是特殊許可權作業,因此過度配置驅動程式會將此 OID 集合要求發出至網路適配器上 PCIe 實體函式 (PF) 的迷你埠驅動程式。 PF 迷你埠驅動程序接著會在 VF 上設定指定的電源狀態。

InformationBufferNDIS_OID_REQUEST 結構的成員包含 NDIS_SRIOV_SET_VF_POWER_STATE_PARAMETERS 結構的指標。

言論

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

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

  • 電源狀態作業只能影響指定的 VF。 作業不得影響相同網路適配器上的其他 VF 或 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 迷你埠驅動程序必須設定 數據。SET_INFORMATION。BytesNeededNDIS_OID_REQUEST 結構中的成員,以所需的緩衝區大小下限。

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