共用方式為

SRIOV_QUERY_LUID回呼函式 (pcivirt.h)

  • 發行項

取得SR-IOV裝置的本機唯一標識符。

語法

SRIOV_QUERY_LUID SriovQueryLuid;

NTSTATUS SriovQueryLuid(
  [in]  PVOID Context,
  [out] PLUID Luid
)
{...}

參數

[in] Context

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

[out] Luid

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

傳回值

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

備註

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

PF 驅動程式會藉由設定SRIOV_DEVICE_INTERFACE_STANDARD的 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
IRQL PASSIVE_LEVEL