注 このメソッドは、Hyper-V 親パーティションの管理オペレーティング システムで実行されるドライバーの上にある場合にのみ使用できます。
PCI Express (PCIe) 仮想関数 (VF) のミニポート ドライバーは、Hyper-V 子パーティションのゲスト オペレーティング システムで実行されます。 このため、VF ミニポート ドライバーは直接、VF の PCIe 構成領域などのハードウェア リソースにアクセスできません。 VF の PCIe 構成空間にアクセスできるのは、PCIe 物理関数 (PF) のミニポート ドライバーだけです。 PF ミニポート ドライバーは、Hyper-V 親パーティションの管理オペレーティング システムで実行され、VF リソースへの特権アクセス権を持ちます。
管理オペレーティング システムで実行される上にあるドライバーは、ネットワーク アダプター上の指定された VF の PCIe 構成領域からデータを読み取る OID_SRIOV_READ_VF_CONFIG_SPACE のオブジェクト識別子 (OID) メソッド要求を発行します。
たとえば、管理オペレーティング システムで実行される仮想化スタックは、VF ミニポート ドライバーが NDISMGetBusData を呼び出して VF PCIe 構成空間から読み取るときに、OID_SRIOV_READ_VF_CONFIG_SPACEの OID メソッド要求を発行します。
この OID メソッド要求を発行する前に、基になるドライバーは、次の方法で NDIS_SRIOV_READ_VF_CONFIG_SPACE_PARAMETERS 構造体のメンバーを設定する必要があります。
VFId メンバーは、情報の読み取り元となる VF の識別子に設定する必要があります。
Offset メンバーは、データを読み取る VF の PCIe 構成空間内のオフセットに設定する必要があります。
Length メンバーは、VF の PCIe 構成領域から読み取るバイト数に設定する必要があります。
BufferOffset メンバーは、指定された VF の PCI 構成領域から読み取られるデータを格納するバッファー内のオフセット (InformationBuffer メンバーによって参照される) に設定する必要があります。 このオフセットは、NDIS_SRIOV_READ_VF_CONFIG_SPACE_PARAMETERS構造体の先頭からバイト単位 で 指定されます。
OID_SRIOV_READ_VF_CONFIG_SPACEの OID メソッド要求を処理する場合、PF ミニポート ドライバーは、次のガイドラインに従う必要があります。
ミニポート ドライバーは、VFIdNDIS_SRIOV_READ_VF_CONFIG_SPACE_PARAMETERS 構造体のメンバーによって指定された VF に、以前に割り当てられているリソースがあることを確認する必要があります。 ミニポート ドライバーは、OID_NIC_SWITCH_ALLOCATE_VFの OID メソッド要求を通じて VF のリソースを割り当てます。 指定した VF のリソースが割り当てられていない場合、ドライバーは OID 要求に失敗する必要があります。
ミニポート ドライバーは、(NDIS_OID_REQUEST 構造体の InformationBuffer メンバーによって参照される) バッファーが、要求された PCIe 構成空間データを返すのに十分な大きさであることを確認する必要があります。 これが true でない場合、ドライバーは OID 要求を失敗する必要があります。
ミニポート ドライバーは通常、NdisMGetVirtualFunctionBusData呼び出して、要求された PCIe 構成領域を照会します。 ただし、ミニポート ドライバーは、ドライバーが PCIe 構成領域の以前の読み取りまたは書き込み操作からキャッシュされている VF の PCIe 構成領域データを返すこともできます。
注 独立系ハードウェア ベンダー (IHV) が、SR-IOV ドライバー パッケージの一部として仮想バス ドライバー (VBD) を提供する場合、ミニポート ドライバーは NdisMGetVirtualFunctionBusData呼び出してはなりません。 代わりに、ドライバーはプライベート通信チャネルを介して VBD とインターフェイスし、VBD 呼び出し ReadVfConfigBlock要求する必要があります。 この関数は、基になる仮想 PCI (VPCI) バス ドライバーでサポートされている GUID_VPCI_INTERFACE_STANDARD インターフェイスから公開されます。
この OID メソッド要求から正常に戻った後、NDIS_OID_REQUEST 構造体の InformationBuffer メンバーには、呼び出し元によって割り当てられたバッファーへのポインターが含まれます。 このバッファーは、次のように書式設定されます。
VF の PCIe 構成空間の読み取り操作のパラメーターを含む NDIS_SRIOV_READ_VF_CONFIG_SPACE_PARAMETERS 構造体。
PCIe 構成スペースからデータを読み取るための追加のバッファー領域。 ドライバーは、NDIS_SRIOV_READ_VF_CONFIG_SPACE_PARAMETERS 構造体のBufferOffset メンバーによって指定されたオフセットでバッファーにデータをコピーします。