查詢從指定的PCI Express SR-IOV 虛擬函式 (VF) 基位址快取器 (BAR) 讀取的數據,如果值 -1 先寫入它們。
語法
SRIOV_QUERY_PROBED_BARS_2 SriovQueryProbedBars2;
NTSTATUS SriovQueryProbedBars2(
[in] PVOID Context,
[in] USHORT VfIndex,
[out] PULONG BaseRegisterValues
)
{...}
參數
[in] Context
驅動程式定義內容的指標。
[in] VfIndex
要查詢之 VF 的以零起始的索引。
[out] BaseRegisterValues
由PCI裝置中的 BAR 數目所系結之變數陣列的指標。
傳回值
如果作業成功,則傳回STATUS_SUCCESS。 否則,傳回適當的 NTSTATUS 錯誤碼。
言論
此回呼函式是由實體函式 (PF) 驅動程序實作。 當系統想要從指定的虛擬函式 (VF) 基位址緩存器讀取時,就會叫用它。
PF 驅動程式會藉由設定 SRIOV_DEVICE_INTERFACE_STANDARD_2的 QueryProbedBars_2 成員、設定 WDF_QUERY_INTERFACE_CONFIG 結構,以及呼叫 WdfDeviceAddQueryInterface來註冊其實作。
當虛擬化堆疊 (非特殊許可權) 想要找出 VF 的基地址緩存器值之後,會使用 值 (-1) 寫入緩存器之後,由虛擬化堆棧叫用此回呼。 設定PCI裝置時,此程式很傳統,因此結果可讓PCI驅動程式知道裝置啟用後會譯碼的位址空間量。 當非特殊許可權的 VM 寫入 VF 的 BAR 時,具特殊許可權的 VM 可以停止運作。 因此,此例程需要寫入 BAR。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows 10 |
支援的最低伺服器 | Windows Server 2016 |
目標平臺 | 窗戶 |
標頭 | pcivirt.h |
IRQL | PASSIVE_LEVEL |