IGPUPMigration ::SaveImmutableGpup, méthode (igpupvdev.h)
La méthode SaveImmutableGpup fait partie de l’interface IGPUPMigration, conçue pour enregistrer l’état immuable d’un GPU virtuel (vGPU) pendant les processus de migration dynamique.
Syntaxe
HRESULT SaveImmutableGpup(
PLUID DeviceLuid,
UINT64 *Length,
BYTE [] SaveBuffer
);
Paramètres
DeviceLuid
[in] Pointeur vers une structure LUID qui représente l’identificateur unique localement (LUID) de l’appareil dont l’état immuable doit être enregistré.
Length
[in, out] Pointeur vers une variable qui spécifie la longueur en octets de la mémoire tampon vers laquelle SaveBuffer pointe vers. Lors de l’entrée, cette variable spécifie la taille de la mémoire tampon. En sortie, il reçoit le nombre d’octets écrits dans la mémoire tampon.
SaveBuffer
[in, out] Pointeur vers une mémoire tampon allouée par l’appelant qui reçoit l’état immuable de l’appareil.
Valeur de retour
SaveImmutableGpup retourne une valeur HRESULT qui indique l’état de l’appel de méthode. Les valeurs de retour possibles sont les suivantes :
| Valeur de retour | Description |
|---|---|
| S_OK | L’appel de méthode a réussi. |
| E_INVALIDARG | Un argument non valide a été passé à la méthode. |
| E_OUTOFMEMORY | La méthode n’a pas pu allouer de mémoire pour la mémoire tampon. |
Remarques
La méthode SaveImmutableGpup capture l’état immuable d’un appareil vGPU, qui reste constant tout au long de la durée de vie de l’appareil. Cet état est essentiel pour garantir la cohérence pendant la migration dynamique.
Il est généralement appelé pendant la phase de préparation d’un processus de migration dynamique, avant l’enregistrement de l’état mutable de l’appareil.
Pour plus d’informations, consultez migration dynamique sur les machines GPU-P.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | igpupvdev.h |