SRIOV_QUERY_VF_LUID回呼函式 （pcivirt.h）

取得PCI Express SR-IOV 虛擬函式 （VF） 的本機唯一標識碼。

語法

SRIOV_QUERY_VF_LUID SriovQueryVfLuid;

NTSTATUS SriovQueryVfLuid(
  [in]  PVOID Context,
  [in]  USHORT VfIndex,
  [out] PLUID Luid
)
{...}

參數

[in] Context

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

[in] VfIndex

要查詢之 VF 的以零起始的索引。

[out] Luid

實作 介面之SR_IOV裝置之本機唯一標識符的指標。

傳回值

如果作業成功，則傳回STATUS_SUCCESS。 否則，傳回適當的 NTSTATUS 錯誤碼。

言論

此回呼函式是由實體函式 （PF） 驅動程序實作。 當系統想要取得特定虛擬函式的標識碼時，就會叫用它。

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

以下是此回呼函式的範例實作。 PF 驅動程式會呼叫 ZwAllocateLocallyUniqueId 並儲存在裝置內容中，以產生唯一標識符。

NTSTATUS
Virtualization_QueryLuid (
    _In_        PVOID             Context,
    _Out_       PLUID             Luid
    )
{
    PDEVICE_CONTEXT deviceContext;

    PAGED_CODE();

    deviceContext = (PDEVICE_CONTEXT)Context;
    *Luid = deviceContext->Luid;

    return STATUS_SUCCESS;
}

要求

要求	價值
最低支援的用戶端	Windows 10
支援的最低伺服器	Windows Server 2016
目標平臺	窗戶
標頭	pcivirt.h