SRIOV_READ_CONFIG callback function (pcivirt.h)

Reads data from the configuration space of the specified PCI Express SR-IOV Virtual Function (VF).

Syntax

SRIOV_READ_CONFIG SriovReadConfig;

NTSTATUS SriovReadConfig(
  [in]  PVOID Context,
  [out] PVOID Data,
  [in]  USHORT VfIndex,
  [in]  ULONG Offset,
  [in]  ULONG Length
)
{...}

Parameters

[in] Context

A pointer to a driver-defined context.

[out] Data

A pointer to buffer that contains the configuration information to be read from the VF's configuration space.

[in] VfIndex

A zero-based index of the VF to which this read operation applies.

[in] Offset

An offset in bytes to the start of the VF’s configuration space where the read begins.

[in] Length

The length, in bytes, of the data to read from the configuration space.

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 read from the configuration space of a specific virtual function.

The PF driver registers its implementation by setting the ReadVfConfig member of the SRIOV_DEVICE_INTERFACE_STANDARD, 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
IRQL PASSIVE_LEVEL