DXGKDDI_SETVIRTUALFUNCTIONPOWERSTATE callback function (dispmprt.h)

This routine allows a non-privileged virtual machine to change the power state of a PCI Express SR-IOV Virtual Function.

Syntax

DXGKDDI_SETVIRTUALFUNCTIONPOWERSTATE DxgkddiSetvirtualfunctionpowerstate;

NTSTATUS DxgkddiSetvirtualfunctionpowerstate(
  [in] HANDLE Context,
  [in] DXGKARG_SETVIRTUALFUNCTIONPOWERSTATE *pArgs
)
{...}

Parameters

[in] Context

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

[in] pArgs

A pointer to a DXGKARG_SETVIRTUALFUNCTIONPOWERSTATE structure.

Return value

Return STATUS_SUCCESS if the operation succeeds.

Remarks

When all vGPUs are in a D3 state and if the Host doesn’t need the GPU, the physical GPU will be put into a D3 Cold state in which case the PF and all of the VF will become inaccessible until the GPU is powered up again. Upon power up we expect the same PF/VF configuration to be in effect as before the power down.

Requirements

Requirement Value
Header dispmprt.h