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 を呼び出します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Server 2012 以降のバージョンの Windows でサポートされています。 |
| 対象プラットフォーム | デスクトップ |
| Header | wdm.h (Wdm.h を含む) |
| IRQL | IRQL <= APC_LEVEL |