DXGKDDI_SAVEIMMUTABLEMIGRATIONDATA funzione di callback (d3dkmddi.h)

Articolo
05/23/2024

La funzione DxgkDdiSaveImmutableMigrationData di KMD salva i dati non modificabili per una migrazione in tempo reale che sta per iniziare.

Sintassi

DXGKDDI_SAVEIMMUTABLEMIGRATIONDATA DxgkddiSaveimmutablemigrationdata;

NTSTATUS DxgkddiSaveimmutablemigrationdata(
  IN_CONST_HANDLE hAdapter,
  INOUT_PDXGKARG_GPUP_SAVE_IMMUTABLE_MIGRATION_DATA pArgs
)
{...}

Parametri

hAdapter

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

pArgs

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

Valore restituito

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

Commenti

Dopo aver chiamato la funzione DxgkDdiPrepareLiveMigration di KMD, Dxgkrnl chiamaDxgkDdiSaveImmutableMigrationData per raccogliere informazioni sul dispositivo da ripristinare sul lato di destinazione. Questo punto è anche un'opportunità per il sistema di convalidare la configurazione del remoto, quindi DxgkDdiSaveImmutableMigrationData deve creare un pacchetto di informazioni sufficienti per convalidare tutti i dati di convalida hardware, firmware o driver in grado di rilevare la capacità di spostare la VF nella configurazione di destinazione.

Il driver deve archiviare i dati relativi alla VF che non cambieranno mentre è attivo che il KMD della destinazione può usare per inizializzare il nuovo VF. Questi dati non devono includere i parametri di creazione della vGPU, perché verranno trasferiti in livelli inferiori e usati per creare la vGPU usando la normale DDI. Ciò può includere tutti i dati non modificabili associati alla funzione VF e non è tutto necessario ripristinarli sul lato di destinazione. I dati possono essere inviati esclusivamente a scopo di convalida, che è una parte fondamentale di questa interfaccia.

DxgkDdiSaveImmutableMigrationData viene chiamato nel modello di buffer dinamico classico:

Nella prima chiamata , DataSize è impostato su 0 e Data su NULL. Il kmD deve modificare DataSize in base 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 impostato sul valore restituito dal KMD e dai dati che puntano al buffer allocato. Dxgkrnl controlla la durata di questa memoria allocata dopo la chiamata.

DxgkDdiSaveMutableMigrationData viene chiamato alla fine di una migrazione in tempo reale per raccogliere dati modificabili.

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