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 或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 錯誤。