DXGKDDI_SAVEMEMORYFORHOTUPDATE callback function (d3dkmddi.h)

Article
10/21/2021

Before the driver is unloaded, it must call the DXGKDDI_SAVEMEMORYFORHOTUPDATE callback function to save information. This information is required to continue running virtual GPUs after the driver is started again.

Syntax

DXGKDDI_SAVEMEMORYFORHOTUPDATE DxgkddiSavememoryforhotupdate;

NTSTATUS DxgkddiSavememoryforhotupdate(
  [in] IN_CONST_HANDLE hContext,
  [in] IN_CONST_PDXGKARG_SAVEMEMORYFORHOTUPDATE pArgs
)
{...}

Parameters

[in] hContext

A handle to the miniport context that is returned by the driver in DXGKDDI_DRIVERHOTUPDATE_INTERFACE.

[in] pArgs

A pointer to a PDXGKARG_SAVEMEMORYFORHOTUPDATE structure.

Return value

Return STATUS_SUCCESS if the operation succeeds.

Remarks

This callback supports driver hot update. Before the driver is unloaded, it is called to save information, which is required to continue running virtual GPUs after it is started again. The driver needs to have the state of every active virtual GPU (virtual function). In the context of a DxgkDdiSaveMemoryForHotUpdate call, the driver could call DxgkCbSaveMemoryForHotUpdate multiple times to save information about running virtual GPUs and other adapter information needed to restore the virtual GPU state after the device is started again.

Requirements

Requirement	Value
Minimum supported client	Windows 10, version 1903
Header	d3dkmddi.h
IRQL	<= APC_LEVEL

Share via