GET_VIRTUAL_DEVICE_LOCATION回呼函式 (wdm.h)
GetLocation 例程會傳回 PCI Express (PCIe) 虛擬函式的裝置位置， (PCI 總線上的 VF) 。 支援單一根目錄 I/O 虛擬化 (SR-IOV) 介面的裝置可以在 PCI 總線上公開一或多個 VM。
語法
GET_VIRTUAL_DEVICE_LOCATION GetVirtualDeviceLocation;
NTSTATUS GetVirtualDeviceLocation(
[in, out] PVOID Context,
[in] USHORT VirtualFunction,
[out] PUINT16 SegmentNumber,
[out] PUINT8 BusNumber,
[out] PUINT8 FunctionNumber
)
{...}
參數
[in, out] Context
介面特定內容資訊的指標。 呼叫端會傳遞值，這個值會當做介面之PCI_VIRTUALIZATION_INTERFACE結構的內容成員傳遞。
[in] VirtualFunction
以零起始的值，指定傳回裝置位置之裝置上的 VF
[out] SegmentNumber
呼叫端提供的變數指標，此例程會傳回目前PCI區段號碼的UINT16值。 這個值會指定連接裝置的PCI總線群組。
[out] BusNumber
呼叫端提供的變數指標，這個例程會傳回 UINT8 值。 這個值會指定裝置所連接的目前PCI總線號碼。
[out] FunctionNumber
呼叫端提供的變數指標，這個例程會傳回 UINT8 值。 這個值包含PCI總線上所指定VF的函式編號。
傳回值
GetLocation 例程會傳回下列其中一個 NTSTATUS 值：
| 傳回碼 | Description |
|---|---|
| STATUS_SUCCESS | 作業已成功完成。 |
| STATUS_INVALID_PARAMETER | VirtualFunction 參數大於裝置 SR-IOV 擴充功能結構之 TotalVFs 成員的值。 |
備註
GetLocation 例程會傳回PCIe階層中 VF 的目前裝置位置。 對於使用 I/O 記憶體管理單位的虛擬化系統， (IOMMU) 將流量路由傳送至裝置或從裝置傳送流量，這是必要的資訊。
從 呼叫 GetLocation 例程成功傳回時， FunctionNumber 參數會包含值，代表 PCI 總線上指定 VF 的函式編號。 此值是以 PCI Express 3.0 規格的 [替代路由解譯 (ARI) 選項為基礎。 ARI 會將 PCIe 總線視為具有 8 位函式空間的單一裝置，允許在總線上使用 256 個函式。
GetLocation 例程是由 GUID_PCI_VIRTUALIZATION_INTERFACE 介面所提供。
VF 所在的PCI總線號碼可以變更。 不建議驅動程式將 VF 的裝置位置儲存在非卷積記憶體中，例如登錄。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Server 2012 和更新版本的 Windows Server 支援。 |
| 目標平台 | 桌面 |
| 標頭 | wdm.h (包含 Wdm.h) |
| IRQL | PASSIVE_LEVEL |