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

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

構文

SET_VIRTUAL_DEVICE_DATA SetVirtualDeviceData;

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

パラメーター

[in, out] Context

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

[in] VirtualFunction

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

[in] Buffer

VF の PCIe 構成空間に書き込まれる構成情報を格納しているバッファーへのポインター。

[in] Offset

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

[in] Length

書き込むデータの長さ (バイト単位)。

戻り値

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

注釈

*SetVirtualFunctionData ルーチンは SetBusData ルーチンに似ていますが、PCIe 構成データをデバイスの物理関数 (PF) ではなく VF に書き込む点が除きます。

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

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

要件

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

こちらもご覧ください

SetBusData

PCI_VIRTUALIZATION_INTERFACE