SRIOV_GET_DEVICE_LOCATION pcivirt.h (回呼函式)

擷取總線上PCI裝置目前位置的相關信息，例如PCI區段、總線、裝置和函式號碼。

語法

SRIOV_GET_DEVICE_LOCATION SriovGetDeviceLocation;

void SriovGetDeviceLocation(
  [in]  PVOID Context,
  [in]  USHORT VfIndex,
  [out] PUINT16 SegmentNumber,
  [out] PUINT8 BusNumber,
  [out] PUINT8 FunctionNumber
)
{...}

參數

[in] Context

驅動程式定義內容的指標。

[in] VfIndex

套用此讀取作業之 VF 之以零起始的索引。

[out] SegmentNumber

填入目前區段號碼之變數的指標，描述此裝置所連接的PCI總線群組。

[out] BusNumber

填入目前總線號碼之變數的指標，描述此裝置所連接的PCI總線。

[out] FunctionNumber

以 FunctionNumber 填入之變數的指標，進一步描述可在此總線上找到裝置的位置。

傳回值

無

備註

此回呼函式是由實體函式 (PF) 驅動程式實作。 當系統想要擷取裝置位置時，就會叫用它。

PF 驅動程式會藉由設定SRIOV_DEVICE_INTERFACE_STANDARD的 GetDeviceLocation 成員、設定WDF_QUERY_INTERFACE_CONFIG結構，以及呼叫 WdfDeviceAddQueryInterface 來註冊其實作。

規格需求

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