SET_VIRTUAL_DEVICE_DATA回呼函式 (wdm.h)
SetVirtualFunctionData 例程會將數據寫入支援單一根 I/O 虛擬化 (SR-IOV) 介面之裝置上的虛擬函式 (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。
[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。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows Server 2012 和更新版本的 Windows 支援。 |
目標平臺 | 桌面 |
標頭 | wdm.h (包括 Wdm.h) |
IRQL | IRQL <= APC_LEVEL |