IVMDisplay：：SetDimensions 方法

[自 Windows 8 起，Windows 虚拟电脑不再可用。请改用 Hyper-V WMI 提供程序 (V2) 。]

设置虚拟机 (VM) 显示的高度和宽度（以像素为单位）。

语法

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

displayPixelWidth [in]: 宽度（以像素为单位）。该值必须介于 640 和 2048 之间。如果该值不均匀地被 8 整除，则它将减少到下一个较低的倍数 8。
displayPixelHeight [in]: 高度（以像素为单位）。该值必须介于 480 和 1920 之间。

此方法可以返回其中一个值。

返回代码/值	说明
S_OK 0	操作成功。
E_INVALIDARG 0x80000003	displayPixelWidth 参数不能被 8 整除，或者 displayPixelWidth 或 displayPixelHeight 参数超出允许的最小 (640x480) 或最大 2048x1920) 值。
VM_E_TIMED_OUT 0xA0040202	解决方案更改未及时完成。
VM_E_VM_NOT_RUNNING 0xA0040206	虚拟机必须运行才能执行此操作。
VM_E_VM_UNKNOWN 0xA0040207	虚拟机无效或当前未运行。
VM_E_NO_DISPLAY 0xA0040850	找不到 VM 的有效显示器。
VM_E_ADDITIONS_FEATURE_NOT_AVAIL 0xA0040505	来宾操作系统中安装的集成组件的版本不支持此操作。
DISP_E_EXCEPTION 0x80020009	发生意外错误。

虚拟机显示器的最小大小为 640 x 480 像素。最大大小为 2048 x 1920。尝试将显示大小设置为超出这些限制的值，或设置为不均匀被 8 整除的任何宽度，将导致返回 E_INVALIDARG 错误。