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構造体の Context メンバーとして渡される値を渡します。

[in] VirtualFunction

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

[out] Buffer

VF の PCIe 構成空間から読み取られた構成情報を含むバッファーへのポインター。

[in] Offset

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

[in] Length

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

戻り値

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

注釈

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

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

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

要件

こちらもご覧ください

PCI_VIRTUALIZATION_INTERFACE

GetBusData