DXGKDDI_RESTOREIMMUTABLEMIGRATIONDATA fonction de rappel (d3dkmddi.h)

Les appels de système d’exploitation côté réception DxgkDdiRestoreImmutableMigrationData pour restaurer des données immuables enregistrées par le pilote côté envoi dans un appel précédent à DxgkDdiSaveImmutableMigrationData.

Syntaxe

DXGKDDI_RESTOREIMMUTABLEMIGRATIONDATA DxgkddiRestoreimmutablemigrationdata;

NTSTATUS DxgkddiRestoreimmutablemigrationdata(
  IN_CONST_HANDLE hAdapter,
  IN_CONST_PDXGKARG_GPUP_RESTORE_IMMUTABLE_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] Pointeur vers une structure DXGKARG_GPUP_RESTORE_IMMUTABLE_MIGRATION_DATA qui contient des informations nécessaires pour restaurer les données immuables.

Valeur de retour

DxgkDdiRestoreImmutableMigrationData retourne STATUS_SUCCESS si l’appel réussit. Sinon, il retourne un code NTSTATUS approprié, tel que le code d’erreur STATUS_OBJECT_TYPE_MISMATCH (voir Remarques).

Remarques

Contrairement au côté d’enregistrement/envoi appelé deux fois, DxgkDdiRestoreImmutableMigrationData est appelé une seule fois, car il a toutes les données nécessaires pour présenter une mémoire tampon de données complète au KMD côté réception. Le pilote doit prendre les données et l’appliquer à la machine virtuelle en cours de construction, ainsi que tout suivi pour celui-ci, et il doit valider les invariants de données nécessaires pour une restauration réussie.

La mémoire tampon est le contenu qui a été rempli côté source dans DxgkDdiSaveImmutableMigrationData, de sorte que KMD doit suivre ces données dans un type commun. Il doit également y avoir un schéma de contrôle de version implémenté dans les données de contenu si les données peuvent avoir besoin de changer avec de nouveaux pilotes, et ce schéma doit faire partie de la vérification de version effectuée sur la cible.

Si les données indiquent que le système cible n’est pas configuré correctement pour que la machine virtuelle soit migrée à partir de la source, KMD doit effectuer les opérations suivantes :

1. Signalez ce problème via le DxgkCbLogEtwEvent avec l’identificateur GUID_DxgkAzureTriageEvent et des détails spécifiques sur les échecs de validation afin que le problème puisse être trié et corrigé.
2. Retournez à partir de cet appel DDI avec l’erreur STATUS_OBJECT_TYPE_MISMATCH.

DxgkDdiRestoreImmutableMigrationData ne doit jamais être appelé pour les machines virtuelles actuellement suspendues.

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

Exigences

Voir aussi

DXGKARG_GPUP_RESTORE_IMMUTABLE_MIGRATION_DATA

DxgkDdiSaveImmutableMigrationData