Поделиться через

Метод IVMDisplay::SetDimensions

  • Статья

[Виртуальный компьютер Windows больше недоступен для использования с Windows 8. Вместо этого используйте поставщик WMI Hyper-V (V2).]

Задает высоту и ширину отображения виртуальной машины (в пикселях).

Синтаксис

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_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
Заголовок
VPCCOMInterfaces.h
IID
 IID_IVMDisplay определяется как 960895e9-f743-4498-96aa-261f867e7fc5

См. также раздел

IVMDisplay