OID_SRIOV_READ_VF_CONFIG_SPACE
基になるドライバーは、ネットワーク アダプター上の指定された PCIe 仮想関数 (VF) の PCI Express (PCIe) 構成領域からデータを読み取るOID_SRIOV_READ_VF_CONFIG_SPACEのオブジェクト識別子 (OID) メソッド要求を発行します。
この OID メソッド要求から正常に戻った後、 NDIS_OID_REQUEST 構造体の InformationBuffer メンバーには、呼び出し元が割り当てたバッファーへのポインターが含まれています。 このバッファーは、次のようにフォーマットされます：
VF の PCI 構成領域の読み取り操作のパラメーターを含む NDIS_SRIOV_READ_VF_CONFIG_SPACE_PARAMETERS 構造体。
PCI 構成領域からデータを読み取るための追加のバッファー領域。
解説
VF ミニポート ドライバーは、Hyper-V 子パーティションのゲスト オペレーティング システムで実行されます。 このため、VF ミニポート ドライバーは、VF の PCI 構成領域などのハードウェア リソースに直接アクセスできません。 VF の PCI 構成領域にアクセスできるのは、PCIe 物理関数 (PF) のミニポート ドライバーだけです。 PF ミニポート ドライバーは、Hyper-V 親パーティションの管理オペレーティング システムで実行され、VF リソースへのアクセス権限を持ちます。
VF PCI 構成領域を読み取るために、管理オペレーティング システムで実行される上位ドライバーは、PF ミニポート ドライバーに OID_SRIOV_READ_VF_CONFIG_SPACE の OID メソッド要求を発行します。 この OID メソッド要求は、シングルルート I/O 仮想化 (SR-IOV) インターフェイスをサポートする PF ミニポート ドライバーに必要です。
例えば、管理オペレーティング システムで実行される仮想化スタックは、VF ミニポート ドライバーが NdisMGetBusData を呼び出して VF PCI 構成領域から読み取るときに、OID_SRIOV_READ_VF_CONFIG_SPACEの OID メソッド要求を発行します。
OID_SRIOV_READ_VF_CONFIG_SPACE の OID メソッド要求を処理する場合、PF ミニポート ドライバーは、次のガイドラインに従う必要があります：
PF ミニポート ドライバーは、 NDIS_SRIOV_READ_VF_CONFIG_SPACE_PARAMETERSS 構造体の VFId メンバーによって指定された VF に、以前に割り当てられているリソースがあることを確認する必要があります。 PF ミニポート ドライバーは、 OID_NIC_SWITCH_ALLOCATE_VF の OID メソッド要求を通じて VF のリソースを割り当てます。 指定した VF のリソースが割り当てられていない場合、ドライバーは OID 要求に失敗する必要があります。
ミニポート ドライバーは、（ NDIS_OID_REQUEST 構造体の InformationBuffer メンバーによって参照される）バッファーが、要求された PCIe 構成領域データを返すのに十分な大きさであることを確認する必要があります。 これが真でない場合、ドライバーは OID 要求を失敗する必要があります。
ミニポート ドライバーは、通常 NdisMGetVirtualFunctionBusData を呼び出して、要求された PCIe 構成領域を照会します。 ただし、ミニポート ドライバーは、ドライバーが PCIe 構成領域の以前の読み取りまたは書き込み操作からキャッシュされている VF の PCIe 構成領域データを返すこともできます。
注 独立系ハードウェア ベンダー (IHV) が SR-IOV ドライバー パッケージ の一部として仮想バス ドライバー (VBD) を提供する場合、そのミニポート ドライバーは NdisMGetVirtualFunctionBusDataを呼び出してはなりません。 代わりに、ドライバーはプライベートコミュニケーションチャネルを介して VBD とインターフェイスし、VBDが ReadVfConfigBlock を呼び出すように要求する必要があります。 この関数は、下位仮想 PCI (VPCI) バス ドライバーでサポートされている GUID_VPCI_INTERFACE_STANDARD インターフェースから公開されます。
PF ミニポート ドライバーが OID 要求を正常に完了できる場合、ドライバーは、要求された PCI 構成領域データを, NDIS_OID_REQUEST 構造体の InformationBuffer メンバーによって参照されるバッファにコピーする必要があります。 ドライバーは、 NDIS_SRIOV_READ_VF_CONFIG_SPACE_PARAMETERS 構造体の BufferOffset メンバーによって指定されたオフセットでバッファーにデータをコピーします。
詳細については、 仮想関数の PCI 構成データの照会 を参照してください。
状態コードを返します
PF ミニポート ドライバーは、OID_SRIOV_READ_VF_CONFIG_SPACE の OID メソッド要求の次の状態コードのいずれかを返します：
| 状態コード | 説明 |
|---|---|
NDIS_STATUS_SUCCESS |
OID 要求は正常に完了しました。 |
NDIS_STATUS_NOT_SUPPORTED |
ミニポート ドライバーがシングル ルート I/O 仮想化 (SR-IOV) インターフェイスをサポートしていないか、インターフェイスの使用が有効になっていません。 |
NDIS_STATUS_INVALID_PARAMETER |
NDIS_SRIOV_READ_VF_CONFIG_SPACE_PARAMETERS 構造体のメンバーの1つ以上に無効な値があります。 |
NDIS_STATUS_INVALID_LENGTH |
情報バッファーが短すぎました。 ミニポートドライバーは、 NDIS_OID_REQUEST 構造体の DATA.METHOD_INFORMATION.BytesNeeded メンバーに必要最小限のバッファーサイズを設定する必要があります。 |
NDIS_STATUS_FAILURE |
その他の理由で要求に失敗しました。 |
要件
バージョン |
NDIS 6.30 以降でサポートされています。 |
ヘッダー |
Ntddndis.h (Ndis.h を含む) |
関連項目
NDIS_SRIOV_READ_VF_CONFIG_SPACE_PARAMETERS