SRIOV_WRITE_CONFIG callback function (pcivirt.h)

Article
02/22/2024

Writes configuration data to a PCI Express SR-IOV Virtual Function (VF).

Syntax

SRIOV_WRITE_CONFIG SriovWriteConfig;

NTSTATUS SriovWriteConfig(
  [in] PVOID Context,
  [in] const VOID *Data,
  [in] USHORT VfIndex,
  [in] ULONG Offset,
  [in] ULONG Length
)
{...}

Parameters

[in] Context

A pointer to a driver-defined context.

[in] Data

A pointer to buffer that contains the data to be written to the configuration space.

[in] VfIndex

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

[in] Offset

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

[in] Length

The length, in bytes, of the data to write to 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 write to the configuration space of a specific virtual function.

The PF driver registers its implementation by setting the WriteVfConfig 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

Share via