IVMDisplay::SetDimensions 方法

[Windows 虚拟电脑不再可用于Windows 8。 请改用 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 或 displayPixelWidthdisplayPixelHeight 参数除允许的最小 (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 错误。

要求

要求
最低受支持的客户端
Windows 7 [仅限桌面应用]
最低受支持的服务器
无受支持的版本
客户端支持结束
Windows 7
Products
Windows Virtual PC
标头
HTTPCOMInterfaces.h
IID
IID_IVMDisplay定义为 960895e9-f743-4498-96aa-261f867e7fc5

另请参阅

IVMDisplay