共用方式為


SRIOV_QUERY_PROBED_BARS_2回呼函式 (pcivirt.h)

查詢從指定的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_2QueryProbedBars_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