仮想関数の PCI ベース アドレス レジスターのクエリ
注 このメソッドは、Hyper-V 親パーティションの管理オペレーティング システムで実行されるドライバーの上にある場合のみ使用できます。
Hyper-V 親パーティションの管理オペレーティング システムで実行される PCI バス ドライバーは、ネットワーク アダプターの各 PCI ベース アドレス レジスター (BAR) のメモリまたは I/O アドレス空間の要件を照会します。 PCI バス ドライバーは、バス上のアダプターを最初に検出するときに、このクエリを実行します。
この PCI BAR クエリを使用して、PCI バス ドライバーは次を決定します。
PCI BAR がネットワーク アダプターでサポートされているかどうか。
BAR がサポートされている場合、BAR に必要なメモリまたは I/O アドレス空間はどのくらいか。
PCI ドライバーは、以下の方法でこの PCI BAR クエリを実行します。
PCI ドライバーはまず、すべてのデータを BAR に書き込みます。
その後、PCI ドライバーは BAR を読み取り、BAR に必要なメモリまたはアドレス空間を決定します。 値 0 は、BAR がネットワーク アダプターでサポートされていないことを示しています。
仮想 PCI (VPCI) バス ドライバーは、Hyper-V 子パーティションのゲスト オペレーティング システムで実行されます。 PCI Express (PCIe) 仮想関数 (VF) が子パーティションに接続されている場合、VPCI バス ドライバーは VF (VF ネットワーク アダプター) の仮想ネットワーク アダプターを公開します。 これを行う前に、VPCI バス ドライバーは PCI BAR クエリを実行して、VF ネットワーク アダプターに必要なメモリまたはアドレス空間を決定する必要があります。
PCI 構成領域へのアクセスは権限操作であるため、Hyper-V 親パーティションの管理オペレーティング システムで実行されるコンポーネントによってのみ実行できます。 VPCI バス ドライバーが PCI BAR に対してクエリを実行すると、NDIS は PF ミニポート ドライバーに OID_SRIOV_PROBED_BARS のオブジェクト識別子 (OID) クエリ要求を発行します。 この OID クエリ要求によって返される結果は VPCI バス ドライバーに転送されるため、VF ネットワーク アダプターで必要なメモリ アドレス空間の量を判断できます。
注 OID_SRIOV_BAR_RESOURCES の OID 要求は、NDIS によってのみ発行できます。 フィルター ドライバーやプロトコルなど、上位ドライバーによって OID 要求を発行することはできません。
OID_SRIOV_PROBED_BARS クエリ要求には、NDIS_SRIOV_PROBED_BARS_INFO 構造が含まれています。 PF ミニポート ドライバーがこの OID を処理する場合、ドライバーは、NDIS_SRIOV_PROBED_BARS_INFO 構造の BaseRegisterValuesOffset メンバーによって参照される配列内の PCI BAR 値を返す必要があります。 配列内のオフセットごとに、PF ミニポート ドライバーは、物理ネットワーク アダプターの PCI 構成空間内の同じオフセットにある BAR の ULONG 値に配列要素を設定する必要があります。
ドライバーによって返される各 BAR 値は、管理オペレーティング システムで実行される PCI ドライバーによって実行される PCI BAR クエリに従うのと同じ値である必要があります。 PF ミニポート ドライバーは、この情報を決定する NdisMQueryProbedBars を呼び出すことができます。
PCI デバイスのベース アドレス レジスタについて詳しくは、「PCI ローカル バス仕様」をご覧ください。