IVMDisplay :: _ GenerateThumbnail, méthode

[Windows Virtual PC ne peut plus être utilisé à partir de Windows 8. Au lieu de cela, utilisez le fournisseur WMI Hyper-V (v2).]

Récupère un tableau de pixels représentant une image miniature de l’écran de l’ordinateur virtuel.

Syntaxe

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

Paramètres

thumbnailimage [ à]

Tableau de pixels représentant une image miniature de l’écran de la machine virtuelle.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code/valeur de retour Description
S _ OK
0
L'opération a réussi.
E _ POINTEUR
0x80004003
Le paramètre a la valeur null.
DISP _ E _ exception
0x80020009
Une erreur inattendue s’est produite.

Remarques

Cette interface retourne plus efficacement la miniature que la propriété thumbnail , mais elle n’est pas utilisable à partir de scripts de clients. La miniature est toujours de 64 pixels de large de 48 pixels de haut. Chaque pixel est 32 bits, où les 8 bits de poids fort représentent la valeur bleue du pixel, les 8 bits suivants représentent la valeur verte du pixel, et les 8 bits suivants représentent la valeur rouge du pixel. Les 64 premiers éléments du tableau sont la première ligne de la miniature, les 64 suivants sont la deuxième ligne, et ainsi de suite. Cette méthode retourne un tableau statique de pixels, qui est plus efficace que le retour d’un SAFEARRAY de valeurs Variant , mais n’est pas compatible avec les clients de script.

Configuration requise

Condition requise Valeur
Client minimal pris en charge
applications de [ bureau Windows 7 uniquement]
Serveur minimal pris en charge
Aucun pris en charge
Fin de la prise en charge des clients
Windows 7
Produit
Windows Virtual PC
En-tête
VPCCOMInterfaces. h
IID
IID _ IVMDisplay est défini en tant que 960895e9-f743-4498-96aa-261f867e7fc5

Voir aussi

IVMDisplay