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_2的QueryProbedBars_2成員、設定WDF_QUERY_INTERFACE_CONFIG結構，以及呼叫 WdfDeviceAddQueryInterface 來註冊其實作。

此回呼是由虛擬化堆疊叫用 (非特殊許可權) ，當想要在緩存器以 (-1) 值寫入 VF 的基地址緩存器值時。 此程式在設定PCI裝置時是傳統的，結果可讓PCI驅動程式知道裝置在啟用之後將譯碼的位址空間量。 當非特殊許可權的 VM 寫入 VF 的 BAR 時，特殊許可權的 VM 可以停止運作。 因此，此例程需要寫入 BAR。

規格需求

需求	值
最低支援的用戶端	Windows 10
最低支援的伺服器	Windows Server 2016
目標平台	Windows
標頭	pcivirt.h
IRQL	PASSIVE_LEVEL