VPCI_INTERFACE_STANDARD 構造体 (vpci.h)

[アーティクル]
02/26/2024

VPCI_INTERFACE_STANDARD インターフェイス構造を使用すると、デバイスドライバーは、単一ルート I/O 仮想化 (SR-IOV) インターフェイスをサポートするデバイスの PCI Express (PCIe) 仮想関数 (VF) に固有の構成データのブロックにアクセスできます。

この構造体は、 GUID_VPCI_INTERFACE_STANDARD インターフェイスについて説明します。

注意

VF 構成ブロックの場所と構成データの形式は、デバイスの独立したハードウェアベンダー (IHV) によって定義されます。これらは、PCIe 物理機能 (PF) と VF のドライバーによってのみ使用されます。

構文

typedef struct _VPCI_INTERFACE_STANDARD {
  USHORT                 Size;
  USHORT                 Version;
  PVOID                  Context;
  PINTERFACE_REFERENCE   InterfaceReference;
  PINTERFACE_DEREFERENCE InterfaceDereference;
  PVPCI_WRITE_BLOCK      WriteVfConfigBlock;
  PVPCI_READ_BLOCK       ReadVfConfigBlock;
  UINT32                 SerialNumber;
} VPCI_INTERFACE_STANDARD, *PVPCI_INTERFACE_STANDARD;

メンバー

Size

この構造体のサイズ (バイト単位)。

Version

ドライバー定義インターフェイスのバージョン。

Context

インターフェイス固有のコンテキスト情報へのポインター。

InterfaceReference

インターフェイスの参照カウントをインクリメントする InterfaceReference ルーチンへのポインター。

InterfaceDereference

インターフェイスの参照カウントをデクリメントする InterfaceDereference ルーチンへのポインター。

WriteVfConfigBlock

PCIe VF の構成データのブロックを書き込む WriteVfConfigBlock ルーチンへのポインター。

ReadVfConfigBlock

PCIe VF の構成データのブロックを読み取る ReadVfConfigBlock ルーチンへのポインター。

SerialNumber

デバイス上の PCIe VF のシリアル番号を含む UINT32 値。仮想化スタックは、デバイスで公開されている各 VF に対して一意のシリアル番号を生成します。

注釈

GUID_VPCI_INTERFACE_STANDARD インターフェイスは、仮想 PCI (VPCI) バスドライバーによって提供され、VFs の読み込まれたドライバーの下に階層化された物理デバイスオブジェクト (PDO) を作成します。これらのドライバーは、Hyper-V 子パーティションで実行されるゲストオペレーティングシステムに読み込まれます。

ドライバーは、interfaceType が GUID_VPCI_INTERFACE_STANDARD に設定されたIRP_MN_QUERY_INTERFACE IRP をバスドライバーに送信することで、VPCI_INTERFACE_STANDARD構造体へのポインターを取得します。