SRIOV_QUERY_LUID_VF callback function (pcivirt.h)

Article
02/22/2024

Gets the PCI Express SR-IOV Virtual Function (VF) given a unique identifier.

Syntax

SRIOV_QUERY_LUID_VF SriovQueryLuidVf;

NTSTATUS SriovQueryLuidVf(
  [in]  PVOID Context,
  [in]  LUID Luid,
  [out] PUSHORT VfIndex
)
{...}

Parameters

[in] Context

A pointer to a driver-defined context.

[in] Luid

The local unique identifier of the VF whose index is being retrieved.

[out] VfIndex

A zero-based index of the VF that is being queried.

Return value

Return STATUS_SUCCESS if the operation succeeds. Otherwise, return an appropriate NTSTATUS error code.

Remarks

This callback function is implemented by the physical function (PF) driver. It is invoked when the system wants to get the identifier of a specific virtual function.

The PF driver registers its implementation by setting the QueryLuidVf member of the SRIOV_DEVICE_INTERFACE_STANDARD_2, configuring a WDF_QUERY_INTERFACE_CONFIG structure, and calling WdfDeviceAddQueryInterface.

Requirements

Requirement	Value
Minimum supported client	Windows 10
Minimum supported server	Windows Server 2016
Target Platform	Windows
Header	pcivirt.h

Share via