共用方式為


GET_VIRTUAL_DEVICE_DATA回呼函式 (wdm.h)

GetVirtualFunctionData 例程會從支援單一根目錄 I/O 虛擬化 (SR-IOV) 介面的裝置上的虛擬函式 (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

另請參閱

PCI_VIRTUALIZATION_INTERFACE

GetBusData