IVMDisplay::SetDimensions-Methode

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

Legt die Höhe und Breite der Anzeige des virtuellen Computers (VM) in Pixel fest.

Syntax

HRESULT SetDimensions(
  [in] long displayPixelWidth,
  [in] long displayPixelHeight
);

Parameter

displayPixelWidth [in]

Die Breite in Pixeln. Der Wert muss zwischen den Werten 640 und 2048 sein. Wenn der Wert nicht gleichmäßig durch 8 teilbar ist, wird es auf das nächste untere Vielfache von 8 reduziert.

displayPixelHeight [in]

Die Höhe in Pixeln. Der Wert muss zwischen den Werten 480 und 1920 sein.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode/-wert BESCHREIBUNG
S_OK
0
Der Vorgang wurde durchgeführt.
E_INVALIDARG
0x80000003
Der Parameter "displayPixelWidth " ist nicht gleichmäßig durch 8 oder den DisplayPixelWidth - oder displayPixelHeight-Parameter außerhalb der zulässigen Mindestwerte (640x480) oder maximal 2048x1920).
VM_E_TIMED_OUT
0xA0040202
Die Auflösungsänderung wurde nicht rechtzeitig beendet.
VM_E_VM_NOT_RUNNING
0xA0040206
Der virtuelle Computer muss für diesen Vorgang ausgeführt werden.
VM_E_VM_UNKNOWN
0xA0040207
Der virtuelle Computer ist ungültig oder wird derzeit nicht ausgeführt.
VM_E_NO_DISPLAY
0xA0040850
Eine gültige Anzeige für den virtuellen Computer kann nicht gefunden werden.
VM_E_ADDITIONS_FEATURE_NOT_AVAIL
0xA0040505
Die in dem Gastbetriebssystem installierte Integrationskomponenten unterstützt diesen Vorgang nicht.
DISP_E_EXCEPTION
0x80020009
Ein unerwarteter Fehler ist aufgetreten.

Bemerkungen

Die mindeste Größe der Anzeige des virtuellen Computers beträgt 640 x 480 Pixel. Die maximale Größe beträgt 2048 x 1920. Versuche, die Anzeigegröße auf Werte außerhalb dieser Grenzwerte festzulegen, oder auf keine Breite, die nicht gleichmäßig durch 8 teilbar ist, führt zu einem E_INVALIDARG Fehler, der zurückgegeben wird.

Requirements (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 wird als 960895e9-f743-4498-96aa-261f867e7fc5 definiert.

Weitere Informationen

IVMDisplay