DXGKDDI_SAVEMUTABLEMIGRATIONDATA funzione di callback (d3dkmddi.h)

Articolo
02/06/2025

La funzione DxgkDdiSaveMutableMigrationData raccoglie dati modificabili per una migrazione in tempo reale che sta per terminare.

Sintassi

DXGKDDI_SAVEMUTABLEMIGRATIONDATA DxgkddiSavemutablemigrationdata;

NTSTATUS DxgkddiSavemutablemigrationdata(
  IN_CONST_HANDLE hAdapter,
  INOUT_PDXGKARG_GPUP_SAVE_MUTABLE_MIGRATION_DATA pArgs
)
{...}

Parametri

hAdapter

[in] Handle per un blocco di contesto associato a una scheda di visualizzazione. Il driver miniport di visualizzazione precedentemente fornito questo handle per Dxgkrnl nel MiniportDeviceContext parametro di output della funzione DXGKDDI_ADD_DEVICE.

pArgs

[in/out] Puntatore a una struttura DXGKARG_GPUP_SAVE_MUTABLE_MIGRATION_DATA per informazioni correlate alla chiamata.

Valore restituito

DxgkDdiSaveMutableMigrationData restituisce STATUS_SUCCESS se la chiamata ha esito positivo. In caso contrario, restituisce un codice NTSTATUS appropriato.

Osservazioni

viene chiamato il DxgkDdiSaveMutableMigrationData per raccogliere dati modificabili quando una migrazione in tempo reale sta per terminare. Questa DDI deve essere chiamata solo per le macchine virtuali attualmente sospese.

DxgkDdiSaveMutableMigrationData viene chiamato nel modello di buffer dinamico classico:

Nella prima chiamata DataSize è impostato su 0 e Data su NULL. Il server di gestione delle chiavi deve modificare DataSize al numero totale di byte necessari per archiviare i dati non modificabili.
Dxgkrnl crea un buffer di byte DataSize e effettua una seconda chiamata con DataSize impostata sul valore restituito dal KMD e Data che punta al buffer allocato. Dxgkrnl controlla la durata di questa memoria allocata dopo la chiamata.

viene chiamato il DxgkDdiSaveImmutableMigrationData all'inizio di una migrazione in tempo reale per raccogliere dati non modificabili.

Per altre informazioni, vedere Migrazione in tempo reale nei dispositivi GPU-P.