IVMDisplay::SetDimensions, méthode

[Windows PC virtuel n’est plus disponible pour une utilisation à partir de Windows 8. Utilisez plutôt le fournisseur WMI Hyper-V (V2).]

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

Syntaxe

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

Paramètres

displayPixelWidth [in]

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

displayPixelHeight [in]

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 uniformément divisible par 8 ou le paramètre displayPixelWidth ou displayPixelHeight est en dehors des valeurs minimales autorisées (640x480) ou maximales de 2048x1920).
VM_E_TIMED_OUT
0xA0040202
Le changement de résolution n’a pas terminé en temps opportun.
VM_E_VM_NOT_RUNNING
0xA0040206
La machine virtuelle doit être en cours d’exécution pour cette opération.
VM_E_VM_UNKNOWN
0xA0040207
La machine virtuelle n’est pas valide ou n’est pas en cours d’exécution.
VM_E_NO_DISPLAY
0xA0040850
Impossible de localiser un affichage valide pour la machine virtuelle.
VM_E_ADDITIONS_FEATURE_NOT_AVAIL
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.

Notes

La taille minimale de l’affichage de la machine virtuelle est de 640 x 480 pixels. La taille maximale est de 2048 x 1920. Les tentatives de définition de la taille d’affichage sur les valeurs en dehors de ces limites, ou de toute largeur non uniformément divisible par 8, entraînent une erreur de E_INVALIDARG retournée.

Configuration requise

Condition requise Valeur
Client minimal pris en charge
Windows 7 [applications de bureau 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 comme 960895e9-f743-4498-96aa-261f867e7fc5

Voir aussi

IVMDisplay