仮想関数の PCI 構成データの設定

  • [アーティクル]

PCI Express (PCIe) 仮想関数 (VF) のミニポート ドライバーは、Hyper-V 子パーティションのゲスト オペレーティング システムで実行されます。 このため、VF ミニポート ドライバーは、VF の PCI 構成領域などのハードウェア リソースに直接アクセスできません。 VF の PCI 構成領域にアクセスできるのは、PCIe 物理関数 (PF) のミニポート ドライバーだけです。 PF ミニポート ドライバーは、Hyper-V 親パーティションの管理オペレーティング システムで実行され、VF リソースへのアクセス権限を持ちます。

仮想化スタックなどの上にあるドライバーは、VF ミニポート ドライバーが PCI 構成領域に書き込む NdisMSetBusData を呼び出すときに、OID_SRIOV_WRITE_VF_CONFIG_SPACE の OID セット要求を発行します。

この OID セット要求を発行する前に、基になるドライバーは、次の方法で NDIS_SRIOV_WRITE_VF_CONFIG_SPACE_PARAMETERS構造体のメンバーを設定する必要があります。

  • VFId メンバーを、情報を書き込むため VF の識別子に設定します。

  • Offset メンバーを、データが書き込まれる VF の PCI 構成空間内のオフセットに設定します。

  • Length メンバーを VF の PCI 構成スペースに書き込むためのバイト数に設定します。

  • BufferOffset メンバーを、指定した VF の PCI 構成領域に書き込まれるデータを格納するバッファー内のオフセット (InformationBuffer メンバーによって参照されます) に設定します。 このオフセットは、NDIS_SRIOV_WRITE_VF_CONFIG_SPACE_PARAMETERS 構造体の先頭からバイト単位で指定されます。

OID_SRIOV_WRITE_VF_CONFIG_SPACE の OID メソッド要求を処理する場合、PF ミニポート ドライバーは、これらのガイドラインに従う必要があります：

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

    指定した VF のリソースが割り当てられていない場合、ドライバーは OID 要求に失敗する必要があります。

  • PF ミニポート ドライバーは、 NdisMSetVirtualFunctionBusData を呼び出して、要求された PCI 構成領域に書き込みます。 ただし、ミニポート ドライバーは、ドライバーが PCI 構成領域の以前の読み取りまたは書き込み操作からキャッシュされている VF の PCI 構成領域データを返すこともできます。

    注 独立系ハードウェア ベンダー (IHV) が SR-IOV ドライバー パッケージ の一部として仮想バス ドライバー (VBD) を提供する場合、そのミニポート ドライバーは NdisMSetVirtualFunctionBusDataを呼び出してはなりません。 代わりに、ドライバーはプライベートコミュニケーションチャネルを介して VBD とインターフェイスし、VBDが SetVirtualFunctionDataを呼び出すように要求する必要があります。 この関数は、下位仮想 PCI (VPCI) バス ドライバーでサポートされている GUID_VPCI_INTERFACE_STANDARD インターフェースから公開されます。

PF ミニポート ドライバーが OID 要求を正常に完了できる場合、ドライバーは、要求された PCI 構成領域データを, NDIS_OID_REQUEST 構造体の InformationBuffer メンバーによって参照されるバッファにコピーする必要があります。 ドライバーは、 NDIS_SRIOV_READ_VF_CONFIG_SPACE_PARAMETERS 構造体の BufferOffset メンバーによって指定されたオフセットでバッファーにデータをコピーします。