DXGKDDI_WRITEVIRTUALFUNCTIONCONFIG callback function (dispmprt.h)

Article
10/21/2021

This callback function allows the non-privileged virtual machine to set the contents of a PCI Express SR-IOV Virtual Function’s configuration space values.

Syntax

DXGKDDI_WRITEVIRTUALFUNCTIONCONFIG DxgkddiWritevirtualfunctionconfig;

NTSTATUS DxgkddiWritevirtualfunctionconfig(
  [in]      HANDLE Context,
  [in, out] DXGKARG_WRITEVIRTUALFUNCTIONCONFIG *pArgs
)
{...}

Parameters

[in] Context

The miniport context that is returned by the driver in the DXGKDDI_SRIOV_INTERFACE structure.

[in, out] pArgs

A pointer to a DXGKARG_WRITEVIRTUALFUNCTIONCONFIG structure.

Return value

Return STATUS_SUCCESS if the operation succeeds.

Remarks

Granting the guest partition direct access to the config space can be problematic, so this function provides a method of safely accessing the virtual functions config block.

Note that this should return values and side effects as if written to the virtual device’s config block. Use of this interface may accomplish the write by handling it internally inside the driver supplying the interface or by calling SetVirtualFunctionData (from the PCI_VIRTUALIZATION_INTERFACE of the lower level PDO) or some combination of the two.

Requirements

Requirement	Value
Header	dispmprt.h

Share via