DXGKDDI_SAVEMUTABLEMIGRATIONDATA fonction de rappel (d3dkmddi.h)

Article
02/06/2025

La fonction DxgkDdiSaveMutableMigrationData de KMD collecte des données mutables pour une migration dynamique qui est sur le point de se terminer.

Syntaxe

DXGKDDI_SAVEMUTABLEMIGRATIONDATA DxgkddiSavemutablemigrationdata;

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

Paramètres

hAdapter

[in] Handle vers un bloc de contexte associé à un adaptateur d’affichage. Le pilote miniport d’affichage a précédemment fourni ce handle pour Dxgkrnl dans le paramètre de sortie MiniportDeviceContext de la fonction DXGKDDI_ADD_DEVICE.

pArgs

[in/out] Pointeur vers une structure DXGKARG_GPUP_SAVE_MUTABLE_MIGRATION_DATA pour obtenir des informations relatives à l’appel.

Valeur de retour

DxgkDdiSaveMutableMigrationData retourne STATUS_SUCCESS si l’appel réussit. Sinon, elle retourne un code NTSTATUS approprié.

Remarques

DxgkDdiSaveMutableMigrationData est appelé pour collecter des données mutables lorsqu’une migration dynamique est sur le point de se terminer. Cette DDI ne doit être appelée que pour les machines virtuelles actuellement suspendues.

DxgkDdiSaveMutableMigrationData est appelée dans le modèle de mémoire tampon dynamique classique :

Lors du premier appel, DataSize a la valeur 0 et Data sur NULL. KMD doit modifier DataSize au nombre total d’octets dont il a besoin pour stocker les données immuables.
Dxgkrnl crée une mémoire tampon d'DataSize octets et effectue un deuxième appel avec DataSize défini sur la valeur retournée par KMD et Data pointant vers la mémoire tampon allouée. Dxgkrnl contrôle la durée de vie de cette mémoire allouée après l’appel.

DxgkDdiSaveImmutableMigrationData est appelée au début d’une migration dynamique pour collecter des données immuables.

Pour plus d’informations, consultez migration dynamique sur les appareils GPU-P.