Compartir a través de

IVMDisplay::SetDimensions (método)

  • Artículo

[Windows Virtual PC ya no está disponible para su uso a partir de Windows 8. En su lugar, use el proveedor WMI de Hyper-V (V2).]

Establece el alto y el ancho de la pantalla de la máquina virtual (VM), en píxeles.

Sintaxis

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

Parámetros

displayPixelWidth [in]

Ancho, en píxeles. El valor debe estar entre los valores 640 y 2048. Si el valor no es divisible uniformemente en 8, se reducirá al siguiente múltiplo inferior de 8.

displayPixelHeight [in]

Alto, en píxeles. El valor debe estar entre los valores 480 y 1920.

Valor devuelto

Este método puede devolver uno de estos valores.

Código o valor devuelto Descripción
S_OK
0
 La operación se realizó correctamente.
E_INVALIDARG
0x80000003
 El parámetro displayPixelWidth no es divisible uniformemente por 8 o el parámetro displayPixelWidth o displayPixelHeight está fuera de los valores mínimos permitidos (640x480) o máximo 2048x1920).
VM_E_TIMED_OUT
0xA0040202
 El cambio de resolución no terminó de manera oportuna.
VM_E_VM_NOT_RUNNING
0xA0040206
 La máquina virtual debe ejecutarse para esta operación.
VM_E_VM_UNKNOWN
0xA0040207
 La máquina virtual no es válida o no se está ejecutando actualmente.
VM_E_NO_DISPLAY
0xA0040850
 No se puede encontrar una pantalla válida para la máquina virtual.
VM_E_ADDITIONS_FEATURE_NOT_AVAIL
0xA0040505
 La versión de los componentes de integración instalados en el sistema operativo invitado no admite esta operación.
DISP_E_EXCEPTION
0x80020009
 Se produjo un error inesperado.

Observaciones

El tamaño mínimo de la pantalla de la máquina virtual es de 640 x 480 píxeles. El tamaño máximo es 2048 x 1920. Los intentos de establecer el tamaño de presentación en valores fuera de estos límites, o en cualquier ancho que no se pueda dividir uniformemente en 8, producirán un error de E_INVALIDARG que se devuelve.

Requisitos

Requisito Value
Cliente mínimo compatible
 Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible
 No se admite ninguno
Fin de compatibilidad de cliente
 Windows 7
Producto
 Windows Virtual PC
Encabezado
VPCCOMInterfaces.h
IID
 IID_IVMDisplay se define como 960895e9-f743-4498-96aa-261f867e7fc5

Vea también

IVMDisplay