OID_NIC_SWITCH_VF_PARAMETERS

上部のドライバーまたはユーザー モード アプリケーションは、OID_NIC_SWITCH_VF_PARAMETERS のオブジェクト識別子 (OID) メソッド要求を発行して、ネットワーク アダプター上の PCI Express (PCIe) 仮想機能 (VF) の現在の構成パラメーターを取得します。 OID_NIC_SWITCH_VF_PARAMETERS の OID メソッド要求を介して照会できるのは、OID_NIC_SWITCH_ALLOCATE_VF の OID メソッド要求を介してリソースが割り当てられている VF のみです。

NDIS は、ミニポート ドライバーに対する OID_NIC_SWITCH_VF_PARAMETERS の OID メソッド要求を処理します。

OID メソッドの要求が行われると、NDIS_OID_REQUEST 構造体の InformationBuffer メンバーには、NDIS_NIC_SWITCH_VF_PARAMETERS 構造体へのポインターが含まれます。

解説

上部のドライバーまたはユーザー モード アプリケーションは、VF の識別子に NDIS_NIC_SWITCH_VF_PARAMETERS 構造体の VFId メンバーを設定することによって、クエリを実行する VF を指定します。 上部のドライバーまたはアプリケーションは、次のいずれかの方法で VF 識別子を取得します。

  • OID_NIC_SWITCH_ENUM_VFS の OID メソッド要求を発行する。

    この OID 要求が正常に完了すると、上部のドライバーまたはユーザー モード アプリケーションは、ネットワーク アダプターに割り当てられているすべての VF の一覧を受け取ります。 リスト内の各要素は、VFId メンバーによって VF 識別子が指定されている NDIS_NIC_SWITCH_VF_INFO 構造体です。

  • OID_NIC_SWITCH_ALLOCATE_VF の OID メソッド要求を発行する。

    この OID 要求が正常に完了した場合、上部のドライバーは、返された NDIS_NIC_SWITCH_VF_PARAMETERS 構造体の VFId メンバーで新しく作成された VF の識別子を受け取ります。

    この方法で VF 識別子を取得できるのは、上部のドライバーだけです。

OID メソッド要求から正常に返されると、NDIS_OID_REQUEST 構造体の InformationBuffer メンバーには、NDIS_NIC_SWITCH_VF_PARAMETERS 構造体へのポインターが含まれています。 この構造体には、指定された VF の構成パラメーターが含まれています。

状態コードを返す

NDIS は、ミニポート ドライバーに対する OID_NIC_SWITCH_VF_PARAMETERS の OID メソッド要求を処理し、OID_NIC_SWITCH_VF_PARAMETERS の OID メソッド要求について次の状態コードを返します。

状態コード 説明

NDIS_STATUS_SUCCESS

要求は正常に完了しました。 InformationBuffer メンバーは NDIS_NIC_SWITCH_VF_PARAMETERS 構造体を指します。

NDIS_STATUS_NOT_SUPPORTED

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

NDIS_STATUS_INVALID_PARAMETER

NDIS_NIC_SWITCH_VF_PARAMETERS 構造体の 1 つ以上のメンバーに無効な値が含まれています。

NDIS_STATUS_INVALID_LENGTH

情報バッファーの長さが sizeof(NDIS_NIC_SWITCH_VF_PARAMETERS) 未満です。 NDIS は、NDIS_OID_REQUEST 構造体の DATA.METHOD_INFORMATION.BytesNeeded メンバー を 必要な最小バッファー サイズに設定します。

NDIS_STATUS_INVALID_LENGTH

情報バッファーが短すぎました。 NDIS は、NDIS_OID_REQUEST 構造体の DATA.METHOD_INFORMATION.BytesNeeded メンバー を 必要な最小バッファー サイズに設定します。

NDIS_STATUS_FAILURE

その他の理由で要求に失敗しました。

要件

バージョン

NDIS 6.30 以降でサポートされています。

ヘッダー

Ntddndis.h (Ndis.h を含む)

関連項目


NDIS_NIC_SWITCH_VF_PARAMETERS

NDIS_OID_REQUEST

OID_NIC_SWITCH_ALLOCATE_VF

OID_NIC_SWITCH_ENUM_VFS

NDIS_NIC_SWITCH_VF_INFO

OID_NIC_SWITCH_VF_PARAMETERS