Partager via


IVMDisplay::_GenerateThumbnail, méthode

[Windows Virtual PC n’est plus disponible à partir de Windows 8. Utilisez plutôt le fournisseur WMI Hyper-V (V2).]

Récupère un tableau de pixels représentant une image miniature de l’écran de la machine virtuelle.

Syntaxe

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

Paramètres

thumbnailImage [out]

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_POINTER
0x80004003
Le paramètre est NULL.
DISP_E_EXCEPTION
0x80020009
Une erreur inattendue s’est produite.

Notes

Cette interface retourne la miniature plus efficacement que la propriété Thumbnail , mais n’est pas utilisable à partir des clients de script. La miniature est toujours de 64 pixels de large sur 48 pixels de haut. Chaque pixel est de 32 bits, où les 8 bits supérieurs 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 éléments 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.

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows 7 [applications de bureau 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 comme 960895e9-f743-4498-96aa-261f867e7fc5

Voir aussi

IVMDisplay