SET_VIRTUAL_DEVICE_DATA回呼函式 (wdm.h)

SetVirtualFunctionData 例程會將數據寫入 PCI Express (PCIe) 虛擬函式的設定空間， (VF) 在支援單一根目錄 I/O 虛擬化 (SR-IOV) 介面的裝置上。

語法

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結構的內容成員傳遞。

[in] VirtualFunction

以零起始的值，指定要從中寫入數據之裝置上的 VF。

[in] Buffer

緩衝區的指標，其中包含要寫入 VF 之 PCIe 設定空間的組態資訊。

[in] Offset

VF 之 PCIe 設定空間數據的位移。 這個成員會指定此寫入作業開始的位置。

[in] Length

要寫入之數據的長度，以位元組為單位。

傳回值

*SetVirtualFunctionData 例程會傳回成功寫入作業後所寫入PCIe設定數據的長度，以位元組為單位。 如果寫入作業失敗，例程會傳回零。

備註

*SetVirtualFunctionData 例程類似於 SetBusData 例程，不同之處在於它會將 PCIe 設定數據寫入 VF，而不是寫入裝置的實體函式， (PF) 。

*SetVirtualFunctionData 例程是由 GUID_PCI_VIRTUALIZATION_INTERFACE 介面所提供。 SetBusData 例程是由 GUID_BUS_INTERFACE_STANDARD 介面所提供。

當客體操作系統中執行的驅動程式呼叫 SetBusData 例程時，虛擬化堆疊會呼叫 *SetVirtualFunctionData。

規格需求

另請參閱

SetBusData

PCI_VIRTUALIZATION_INTERFACE