Méthode CalculateVideoMemoryRequirements de la classe Msvm_Synth3dVideoPool

Article
06/13/2023

Calcule la quantité de mémoire vidéo requise pour une machine virtuelle RemoteFX.

Syntaxe

uint32 CalculateVideoMemoryRequirements(
  [in]  uint32 monitorResolution,
  [in]  uint32 numberOfMonitors,
  [out] uint64 requiredVideoMemory
);

Paramètres

monitorResolution [in]

Résolution maximale du moniteur pour la machine virtuelle. Il doit s’agir de l’une des valeurs suivantes.

Valeur	Signification
0	La résolution maximale est 1024 768.
1	La résolution maximale est 1280 1024.
2	La résolution maximale est 1600 1200.
3	La résolution maximale est 1920 1200.

numberOfMonitors [in]

Nombre maximal de moniteurs pour la machine virtuelle. Le nombre minimal d’écrans est d’un et le maximum dépend de la résolution maximale de l’écran. Le tableau suivant définit le nombre maximal de moniteurs autorisés pour différentes résolutions.

Résolution	Nombre maximal de moniteurs
1024 768	4
1280 1024	4
1600 1200	3
1920 1200	2

requiredVideoMemory [out]

Reçoit la quantité de mémoire vidéo requise, en octets.

Valeur retournée

Retourne un code status, qui peut être l’une des valeurs suivantes.

Code/valeur de retour	Description
Terminé avec aucune erreur 0	Réussi.
Paramètres de méthode vérifiés - Travail démarré 4096	Le travail a démarré.
Échec 32 768	Échec.
accès refusé 32769	Accès refusé.
Non pris en charge 32770	Non pris en charge.
L’état est inconnu 32771	L’état est inconnu.
Délai d'expiration 32772	Délai d’expiration.
Paramètre non valide 32773	Un paramètre n'est pas valide.
Le système est en cours d’utilisation 32774	Le système est en cours d’utilisation.
État non valide pour cette opération 32775	L’état n’est pas valide pour cette opération.
Type de données incorrect 32776	Type de données incorrect.
Le système n’est pas disponible 32777	Le système n’est pas disponible.
Mémoire insuffisante 32778	Mémoire insuffisante.

Notes

Cette méthode est généralement appelée sur le système hôte pour déterminer si l’hôte dispose de suffisamment de mémoire vidéo disponible pour héberger une machine virtuelle RemoteFX. Pour ce faire, vous devez comparer la quantité de mémoire vidéo calculée par cette méthode à la propriété Msvm_PhysicalGPUInfo.AvailableVideoMemory pour déterminer si la machine hôte dispose de suffisamment de mémoire vidéo disponible. Vous pouvez utiliser ces informations pour déterminer si une machine virtuelle peut être déplacée vers le système hôte.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau uniquement]
Espace de noms	Racine\Virtualisation\V2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

Voir aussi

Msvm_PhysicalGPUInfo
Msvm_Synth3dVideoPool

Partager via