DXGKDDI_PREPARELIVEMIGRATION callback function (d3dkmddi.h)
Dxgkrnl calls KMD's DxgkDdiPrepareLiveMigration function to notify the driver to prepare for a live migration that is about to start.
Syntax
DXGKDDI_PREPARELIVEMIGRATION DxgkddiPreparelivemigration;
NTSTATUS DxgkddiPreparelivemigration(
IN_CONST_HANDLE hAdapter,
IN_CONST_PDXGKARG_GPUP_PREPARE_LIVE_MIGRATION pArgs
)
{...}
Parameters
hAdapter
[in] A handle to a context block associated with a display adapter. The display miniport driver previously provided this handle to Dxgkrnl in the MiniportDeviceContext output parameter of the DXGKDDI_ADD_DEVICE function.
pArgs
[in] A pointer to a DXGKARG_GPUP_PREPARE_LIVE_MIGRATION structure that contains the information required to prepare for a live migration.
Return value
DxgkDdiPrepareLiveMigration returns STATUS_SUCCESS if it succeeds; otherwise, it returns an appropriate NTSTATUS code.
Remarks
A call to DxgkDdiPrepareLiveMigration allows the driver to configure the virtual function (VF), its scheduling, its own internal state, and anything else needed around managing the migration. The intent of this call is to establish the PF/VF scheduling policies that provide for the live migration’s ability to stream dirty content from the VRAM in the host while preserving fair performance for the VF. If the dirty tracking is reported as nonperformant, this callback is also where the dirty tracking is started.
For more information, see Live migration on GPU-P devices.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 11, version 24H2 (WDDM 3.2) |
| Header | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |