共用方式為

(pcivirt.h) SRIOV_QUERY_VF_LUID 回呼函式

  • 發行項

取得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
目標平台 Windows
標頭 pcivirt.h