Compartilhar via


Método IVMDisplay::_GenerateThumbnail

[Windows Computador Virtual não está mais disponível para uso a partir de Windows 8. Em vez disso, use o provedor WMI do Hyper-V (V2).]

Recupera uma matriz de pixels que representa uma imagem em miniatura da tela da máquina virtual.

Sintaxe

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

Parâmetros

thumbnailImage [out]

A matriz de pixels que representa uma imagem em miniatura da tela da máquina virtual.

Valor retornado

Esse método pode retornar um desses valores.

Código/valor de retorno Descrição
S_OK
0
A operação foi bem-sucedida.
E_POINTER
0x80004003
O parâmetro é NULL.
DISP_E_EXCEPTION
0x80020009
Ocorreu um erro inesperado.

Comentários

Essa interface retorna a miniatura com mais eficiência do que a propriedade Miniatura , mas não é utilizável de clientes de script. A miniatura tem sempre 64 pixels de largura por 48 pixels de altura. Cada pixel é de 32 bits, onde os 8 bits superiores representam o valor azul do pixel, os próximos 8 bits representam o valor verde do pixel e os próximos 8 bits representam o valor vermelho do pixel. Os primeiros 64 elementos na matriz são a primeira linha da miniatura, os próximos 64 elementos são a segunda linha e assim por diante. Esse método retorna uma matriz estática de pixels, que é mais eficiente do que retornar um SAFEARRAY de valores VARIANT , mas não é compatível com clientes de script.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Nenhum compatível
Fim do suporte ao cliente
Windows 7
Produto
Windows Virtual PC
Cabeçalho
VPCCOMInterfaces.h
IID
IID_IVMDisplay é definido como 960895e9-f743-4498-96aa-261f867e7fc5

Confira também

IVMDisplay