Freigeben über


IVMDisplay::_GenerateThumbnail-Methode

[Windows Virtual PC ist ab Windows 8 nicht mehr verfügbar. Verwenden Sie stattdessen den Hyper-V WMI-Anbieter (V2).]

Ruft ein Array von Pixeln ab, das ein Miniaturbild des Bildschirms des virtuellen Computers darstellt.

Syntax

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

Parameter

thumbnailImage [out]

Das Array von Pixeln, das eine Miniaturansicht des Bildschirms des virtuellen Computers darstellt.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode/-wert BESCHREIBUNG
S_OK
0
Der Vorgang wurde durchgeführt.
E_POINTER
0x80004003
Der Parameter ist NULL.
DISP_E_EXCEPTION
0x80020009
Ein unerwarteter Fehler ist aufgetreten.

Bemerkungen

Diese Schnittstelle gibt die Miniaturansicht effizienter als die Thumbnail-Eigenschaft zurück, kann jedoch nicht von Skriptclients verwendet werden. Die Miniaturansicht ist immer 64 Pixel breit und 48 Pixel hoch. Jedes Pixel ist 32 Bit, wobei die oberen 8 Bits den blauen Wert des Pixels, die nächsten 8 Bits den grünen Wert des Pixels und die nächsten 8 Bits den roten Wert des Pixels darstellen. Die ersten 64 Elemente im Array sind die erste Zeile der Miniaturansicht, die nächsten 64 Elemente die zweite Zeile usw. Diese Methode gibt ein statisches Array von Pixeln zurück, das effizienter ist als die Rückgabe eines SAFEARRAY von VARIANT-Werten , aber nicht mit Skriptclients kompatibel ist.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Nicht unterstützt
Ende des Supports (Client)
Windows 7
Produkt
Windows Virtual PC
Header
VPCCOMInterfaces.h
IID
IID_IVMDisplay ist definiert als 960895e9-f743-4498-96aa-261f867e7fc5

Siehe auch

IVMDisplay