IVMDisplay::SetDimensions, méthode

  • Article

[Windows Virtual PC n’est plus disponible à 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 se trouver entre les valeurs 640 et 2048. Si la valeur n’est pas uniformément divisible par 8, elle est 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 2048x1920).
VM_E_TIMED_OUT
0xA0040202
 Le changement de résolution ne s’est 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 2048 x 1920. Les tentatives de définir la taille d’affichage sur des valeurs en dehors de ces limites, ou sur toute largeur non uniformément divisible par 8, entraînent le retour d’une erreur E_INVALIDARG .

Spécifications

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