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
產品
Windows Virtual PC
標頭
HTTPCOMInterfaces.h
IID
IID_IVMDisplay定義為 960895e9-f743-4498-96aa-261f867e7fc5

另請參閱

IVMDisplay