仮想ポートのパラメーターのクエリ

上位のドライバーは、単一ルート I/O 仮想化 (SR-IOV) をサポートするネットワーク アダプターに作成された NIC スイッチの仮想ポート (Vport) パラメーターを取得できます。 ドライバーは、OID_NIC_SWITCH_VPORT_PARAMETERS のオブジェクト識別子 (OID) メソッド要求を発行して、これらのパラメーターを取得します。

上位のドライバーがこの OID メソッド要求を発行する前に、NDIS_NIC_SWITCH_VPORT_PARAMETERS 構造を初期化する必要があります。 ドライバーは、次の方法でこの構造のメンバーを設定する必要があります。

• SwitchId メンバーは、パラメーターを返す NIC スイッチの識別子に設定する必要があります。

  注 Windows Server 2012 以降では、SR-IOV インターフェイスは、ネットワーク アダプターの既定の NIC スイッチを１つのみサポートします。 このスイッチは、既定の NIC スイッチと呼ばれます。 SwitchId メンバーは、NDIS_DEFAULT_SWITCH_ID に設定する必要があります。

• VPortId メンバーは、VPort に関連付けられている識別子に設定してください。 上位のドライバーは、次のいずれかの方法で VPort 識別子を取得します。

  • OID_NIC_SWITCH_CREATE_VPORT の以前の OID メソッド要求から。

  • OID_NIC_SWITCH_ENUM_VPORTS の以前の OID メソッド要求から。

この OID クエリ要求から正常に返されると、NDIS_OID_REQUEST 構造の InformationBuffer メンバーには、NDIS_NIC_SWITCH_VPORT_PARAMETERS 構造へのポインターが含まれています。 この構造には、指定された VPort のパラメーターが含まれています。

NDIS は、ミニポート ドライバーの OID_NIC_SWITCH_VPORT_PARAMETERS 要求を処理します。 NDIS は、次のソースを調査することで、保持されたデータの内部キャッシュから情報を返します。

• OID_NIC_SWITCH_CREATE_VPORT の OID メソッド要求。

• OID_NIC_SWITCH_VPORT_PARAMETERS の OID 設定要求。