Método IVMDisplay::SetDimensions
[O Computador Virtual do Windows não está mais disponível para uso a partir de Windows 8. Em vez disso, use o provedor WMI do Hyper-V (V2).]
Define a altura e a largura da exibição da máquina virtual (VMs), em pixels.
Sintaxe
HRESULT SetDimensions(
[in] long displayPixelWidth,
[in] long displayPixelHeight
);
Parâmetros
-
displayPixelWidth [in]
-
A largura, em pixels. O valor deve estar entre os valores de 640 e 2048. Se o valor não for uniformemente divisível por 8, ele será reduzido para o próximo múltiplo inferior de 8.
-
displayPixelHeight [in]
-
A altura, em pixels. O valor deve estar entre os valores de 480 e 1920.
Valor retornado
Esse método pode retornar um desses valores.
| Retornar código/valor | Descrição |
|---|---|
|
A operação foi bem-sucedida. |
|
O parâmetro displayPixelWidth não é uniformemente divisível por 8 ou o parâmetro displayPixelWidth ou displayPixelHeight está fora dos valores mínimos permitidos (640x480) ou máximo de 2048x1920). |
|
A alteração de resolução não foi concluída em tempo hábil. |
|
A máquina virtual deve estar em execução para essa operação. |
|
A máquina virtual não é válida ou não está em execução no momento. |
|
Não é possível localizar uma exibição válida para a VM. |
|
A versão dos componentes de integração instalados no sistema operacional convidado não dá suporte a essa operação. |
|
Ocorreu um erro inesperado. |
Comentários
O tamanho mínimo da exibição da máquina virtual é de 640 x 480 pixels. O tamanho máximo é 2048 x 1920. As tentativas de definir o tamanho da exibição como valores fora desses limites ou para qualquer largura não uniformemente divisível por 8 resultarão em um erro de E_INVALIDARG ser retornado.
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 |
|
| IID |
IID_IVMDisplay é definido como 960895e9-f743-4498-96aa-261f867e7fc5 |