GET_VIRTUAL_DEVICE_DATA回呼函式 (wdm.h)
GetVirtualFunctionData 例程會在支援單一根 I/O 虛擬化 (SR-IOV) 介面的裝置上，從 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。
[out] Buffer
緩衝區的指標，其中包含從 VF 的 PCIe 設定空間讀取的組態資訊。
[in] Offset
VF 之 PCIe 設定空間數據的位移。 這個成員會指定這個讀取作業開始的位置。
[in] Length
要讀取之數據的長度，以位元組為單位。
傳回值
GetVirtualFunctionData 例程會傳回成功讀取作業之後讀取之PCIe組態數據的長度，以位元組為單位。 如果讀取作業失敗，例程會傳回零。
備註
GetVirtualFunctionData 例程類似於 GetBusData 例程，不同之處在於它會從 VF 讀取 PCIe 組態數據，而不是從裝置的實體函式 (PF) 。
GetVirtualFunctionData 例程是由 GUID_PCI_VIRTUALIZATION_INTERFACE 介面所提供。 GetBusData 例程是由 GUID_BUS_INTERFACE_STANDARD 介面所提供。
當客體操作系統中執行的驅動程式呼叫 GetBusData 例程時，虛擬化堆疊會呼叫 GetVirtualFunctionData。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Server 2012 和更新版本的 Windows 支援。 |
| 目標平台 | 桌面 |
| 標頭 | wdm.h (包含 Wdm.h) |
| IRQL | IRQL <= APC_LEVEL |