次の方法で共有

GET_VIRTUAL_DEVICE_DATA コールバック関数 (wdm.h)

  • [アーティクル]

GetVirtualFunctionData ルーチンは、単一ルート I/O 仮想化 (SR-IOV) インターフェイスをサポートするデバイス上の仮想関数 (VF) の PCI Express (PCIe) 構成空間からデータを読み取ります。

構文

GET_VIRTUAL_DEVICE_DATA GetVirtualDeviceData;

ULONG GetVirtualDeviceData(
  [in, out] PVOID Context,
  [in]      USHORT VirtualFunction,
  [out]     PVOID Buffer,
  [in]      ULONG Offset,
  [in]      ULONG Length
)
{...}

パラメーター

[in, out] Context

インターフェイス固有のコンテキスト情報へのポインター。 呼び出し元は、インターフェイスの PCI_VIRTUALIZATION_INTERFACE 構造体の コンテキスト メンバーとして渡される値を渡します。

[in] VirtualFunction

データの読み取り元となるデバイス上の VF を指定する 0 から始まる値。

[out] Buffer

VF の PCIe 構成空間から読み取られた構成情報を格納しているバッファーへのポインター。

[in] Offset

VF の PCIe 構成空間データへのオフセット。 このメンバーは、この読み取り操作が開始される場所を指定します。

[in] Length

読み取るデータの長さ (バイト単位)。

戻り値

GetVirtualFunctionData ルーチンは、正常な読み取り操作の後に読み取られた PCIe 構成データの長さをバイト単位で返します。 読み取り操作が失敗した場合、ルーチンは 0 を返します。

備考

GetVirtualFunctionData ルーチンは、デバイスの物理機能 (PF) からではなく VF から PCIe 構成データを読み取る点を除き、GetBusData ルーチンに似ています。

GetVirtualFunctionData ルーチンは、GUID_PCI_VIRTUALIZATION_INTERFACE インターフェイスによって提供されます。 GetBusData ルーチンは、GUID_BUS_INTERFACE_STANDARD インターフェイスによって提供されます。

仮想化スタックは、ゲスト オペレーティング システムで実行されているドライバーが getBusData ルーチン 呼び出すと、GetVirtualFunctionData を呼び出します。

必要条件

要件 価値
サポートされる最小クライアント Windows Server 2012 以降のバージョンの Windows でサポートされています。
ターゲット プラットフォーム の デスクトップ
ヘッダー wdm.h (Wdm.h を含む)
IRQL IRQL <= APC_LEVEL

関連項目

PCI_VIRTUALIZATION_INTERFACE

GetBusData を する