OID_NIC_SWITCH_VF_PARAMETERS
基になるドライバーまたはユーザー モード アプリケーションは、ネットワーク アダプター上の PCI Express (PCIe) 仮想関数 (VF) の現在の構成パラメーターを取得するOID_NIC_SWITCH_VF_PARAMETERSのオブジェクト識別子 (OID) メソッド要求を発行します。 OID_NIC_SWITCH_ALLOCATE_VF の OID メソッド要求を通じてリソースが割り当てられている VM のみが、OID_NIC_SWITCH_VF_PARAMETERSの OID メソッド要求を介してクエリを実行できます。
NDIS は、ミニポート ドライバーのOID_NIC_SWITCH_VF_PARAMETERSの OID メソッド要求を処理します。
OID メソッドの要求が行われると、NDIS_OID_REQUEST 構造体の InformationBuffer メンバーには、NDIS_NIC_SWITCH_VF_PARAMETERS 構造体へのポインターが含まれます。
備考
上にあるドライバーまたはユーザー モード アプリケーションは、NDIS_NIC_SWITCH_VF_PARAMETERS 構造体の VFId メンバーを VF の識別子に設定することによって、クエリを実行する VF を指定します。 上にあるドライバーまたはアプリケーションは、次のいずれかの方法で VF 識別子を取得します。
OID_NIC_SWITCH_ENUM_VFSの OID メソッド要求を発行する。
この OID 要求が正常に完了すると、上にあるドライバーまたはユーザー モード アプリケーションは、ネットワーク アダプターに割り当てられているすべての VM の一覧を受け取ります。 リスト内の各要素は NDIS_NIC_SWITCH_VF_INFO 構造体であり、VF 識別子は VFId メンバーによって指定されます。
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 は、データを設定します。METHOD_INFORMATION。BytesNeededNDIS_OID_REQUEST 構造体のメンバーを、必要な最小バッファー サイズに設定します。 |
NDIS_STATUS_INVALID_LENGTH |
情報バッファーが短すぎます。 NDIS は、データを設定します。METHOD_INFORMATION。BytesNeededNDIS_OID_REQUEST 構造体のメンバーを、必要な最小バッファー サイズに設定します。 |
NDIS_STATUS_FAILURE |
その他の理由で要求が失敗しました。 |
必要条件
バージョン |
NDIS 6.30 以降でサポートされています。 |
ヘッダ |
Ntddndis.h (Ndis.h を含む) |