IVMDisplay :: SetDimensions, méthode

[Windows Virtual PC ne peut plus être utilisé à partir de Windows 8. Au lieu de cela, utilisez le fournisseur WMI Hyper-V (v2).]

Définit, en pixels, la hauteur et la largeur de l’affichage de la machine virtuelle.

Syntaxe

HRESULT SetDimensions(
  [in] long displayPixelWidth,
  [in] long displayPixelHeight
);

Paramètres

displayPixelWidth [ dans]

Largeur, en pixels. La valeur doit être comprise entre les valeurs 640 et 2048. Si la valeur n’est pas divisible par 8, elle sera réduite au multiple de 8 inférieur suivant.

displayPixelHeight [ dans]

Hauteur, en pixels. La valeur doit être comprise entre les valeurs 480 et 1920.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code/valeur de retour Description
S _ OK
0
L'opération a réussi.
E _ INVALIDARG
0x80000003
Le paramètre displayPixelWidth n’est pas divisible par 8, ou le paramètre displayPixelWidth ou displayPixelHeight est en dehors des valeurs minimales autorisées (640x480) ou 2048x1920).
Ordinateur virtuel _ E _ a _ expiré
0xA0040202
La modification de la résolution ne s’est pas terminée en temps opportun.
Ordinateur virtuel _ _Machine virtuelle _ non _ exécutée
0xA0040206
L’ordinateur virtuel doit être en cours d’exécution pour cette opération.
Ordinateur virtuel _ _Machine virtuelle _
0xA0040207
inconnue
L’ordinateur virtuel n’est pas valide ou n’est pas en cours d’exécution.
Ordinateur virtuel _ E _ aucun _
0xA0040850
d’affichage
Impossible de trouver un affichage valide pour la machine virtuelle.
Ordinateur virtuel _ La _ fonctionnalité d’ajouts E _ _ n’est pas disponible _
0xA0040505
La version des composants d’intégration installés dans le système d’exploitation invité ne prend pas en charge cette opération.
DISP _ E _ exception
0x80020009
Une erreur inattendue s’est produite.

Remarques

La taille minimale de l’affichage de l’ordinateur virtuel est de 640 x 480 pixels. La taille maximale est de 2048 x 1920. Toute tentative de définition de la taille d’affichage sur des valeurs en dehors de ces limites, ou sur une largeur qui n’est pas divisible par 8, entraîne le renvoi d’une erreur E _ INVALIDARG .

Configuration requise

Condition requise Valeur
Client minimal pris en charge
applications de [ bureau Windows 7 uniquement]
Serveur minimal pris en charge
Aucun pris en charge
Fin de la prise en charge des clients
Windows 7
Produit
Windows Virtual PC
En-tête
VPCCOMInterfaces. h
IID
IID _ IVMDisplay est défini en tant que 960895e9-f743-4498-96aa-261f867e7fc5

Voir aussi

IVMDisplay