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

Метод IVMDisplay::_GenerateThumbnail

  • Статья

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

Извлекает массив пикселей, представляющий эскиз экрана виртуальной машины.

Синтаксис

HRESULT _GenerateThumbnail(
  [out] unsigned long thumbnailImage[3072]
);

Параметры

thumbnailImage [out]

Массив пикселей, представляющий эскиз экрана виртуальной машины.

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

Возвращаемый код/значение Описание
S_OK
0
 Операция выполнена успешно.
E_POINTER
0x80004003
 Параметр имеет значение NULL.
DISP_E_EXCEPTION
0x80020009
 Произошла непредвиденная ошибка.

Комментарии

Этот интерфейс возвращает эскиз более эффективно, чем свойство Thumbnail , но недоступен для клиентов сценариев. Эскиз всегда имеет ширину 64 пикселя и высоту 48 пикселей. Каждый пиксель имеет размер 32 бита, где верхние 8 битов представляют синее значение пикселя, следующие 8 бит — зеленое значение пикселя, а следующие 8 битов — красное значение пикселя. Первые 64 элемента в массиве — это первая строка эскиза, следующие 64 элемента — вторая строка и т. д. Этот метод возвращает статический массив пикселей, который является более эффективным, чем возврат значений SAFEARRAYvariant , но несовместим с клиентами сценариев.

Требования

Требование Значение
Минимальная версия клиента
 Windows 7 [только классические приложения]
Минимальная версия сервера
 Ни одна версия не поддерживается
Окончание поддержки клиентов
 Windows 7
Продукт
 Windows Virtual PC
Заголовок
VPCCOMInterfaces.h
IID
 IID_IVMDisplay определяется как 960895e9-f743-4498-96aa-261f867e7fc5

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

IVMDisplay