次の方法で共有


OID_SRIOV_SET_VF_POWER_STATE

上位ドライバーは、ネットワーク アダプター上の指定された PCI Express (PCIe) 仮想関数 (VF) の電源状態を変更する OID_SRIOV_Standard Edition T_VF_POWER_STATE のオブジェクト識別子 (OID) セット要求を発行します。 電源状態の変更は権限操作であるため、上位ドライバーは、ネットワーク アダプター上の PCIe 物理関数 (PF) のミニポート ドライバーにこの OID セット要求を発行します。 その後、PF ミニポート ドライバーは、VF で指定された電源状態を設定します。

NDIS_OID_REQUEST 構造体の InformationBuffer メンバーには DIS_SRIOV_SET_VF_POWER_STATE_PARAMETERS 構造体へのポインターが含まれています。

解説

PF ミニポート ドライバーがこの OID セット要求を発行する場合は、次のガイドラインに従う必要があります:

  • PF ミニポート ドライバーは、 NDIS_SRIOV_SET_VF_POWER_STATE_PARAMETERS 構造体の VFId メンバーによって指定された VF に、以前に割り当てられているリソースがあることを確認する必要があります。 PF ミニポート ドライバーは、 OID_NIC_SWITCH_ALLOCATE_VF メソッド要求の間に VF のリソースを割り当てます。 指定した VF が割り当てられた状態でない場合、ドライバーは OID 要求を失敗する必要があります。

  • 電源状態操作は、指定された VF にのみ影響を与える必要があります。 この操作は、同じネットワーク アダプター上の他の VM または PF に影響を与えてはなりません。

詳細については、 仮想関数の電源状態の設定 を参照してください。

状態コードを返します

PF ミニポート ドライバーは、OID_SRIOV_SET_VF_POWER_STATE.Eの OID セット要求の次の状態コードのいずれかを返します:

状態コード 説明

NDIS_STATUS_SUCCESS

OID 要求は正常に完了しました。

NDIS_STATUS_NOT_SUPPORTED

ミニポート ドライバーは、シングル ルート I/O 仮想化 (SR-IOV) インターフェイスをサポートしていないか、インターフェイスを使用できません。

NDIS_STATUS_INVALID_PARAMETER

NDIS_SRIOV_SET_VF_POWER_STATE_PARAMETERS 構造体の1つ以上のメンバーに無効な値があります。

NDIS_STATUS_INVALID_LENGTH

情報バッファーが短すぎました。 PF ミニポートドライバーは、 NDIS_OID_REQUEST 構造体の DATA.SET_INFORMATION.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