次の方法で共有

仮想関数のパラメーターのクエリ

  • [アーティクル]

上位のドライバーまたはユーザー モード アプリケーションは、単一ルート I/O 仮想化 (SR-IOV) をサポートするネットワーク アダプター上で PCI Express (PCIe) 仮想関数 (VF) の現在のパラメーターを取得できます。 ドライバーまたはアプリケーションは、OID_NIC_SWITCH_VF_PARAMETERS のオブジェクト識別子 (OID) メソッド要求を発行し、これらのパラメーターを取得します。

上位のドライバーがこの OID メソッド要求を発行する前に、NDIS_NIC_SWITCH_VF_PARAMETERS 構造を初期化する必要があります。 ドライバーまたはアプリケーションは、パラメーターを返す VF の識別子に VFId メンバーを設定する必要があります。 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 要求を処理します。 NDIS は、次のソースを調査することで、保持されたデータの内部キャッシュから情報を返します。