IVMDisplay::SetDimensions-Methode

[Windows Der virtuelle PC ist ab Windows 8 nicht mehr für die Verwendung 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 Pixel. Der Wert muss zwischen den Werten 640 und 2048 sein. Wenn der Wert nicht gleichmäßig durch 8 teilbar ist, wird er auf das nächstuntere Vielfache von 8 reduziert.

displayPixelHeight [ In]

Die Höhe in Pixel. 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 displayPixelWidth-Parameter ist nicht gleichmäßig durch 8 teilbar, oder der displayPixelWidth- oder displayPixelHeight-Parameter liegt außerhalb der zulässigen Mindestwerte (640 x 480) oder maximal 2048 x 1920.
VM _ E _ _ TIMED OUT
0xA0040202
Die Auflösungsänderung wurde nicht rechtzeitig abgeschlossen.
VM _ E _ VM WIRD NICHT _ _ AUSGEFÜHRT,
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
Es konnte keine gültige Anzeige für den virtuellen Computer gefunden werden.
VM _ E _ ADDITIONS _ FEATURE NOT _ _ AVAIL
0XA0040505
Die Im Gastbetriebssystem installierte Version der Integrationskomponenten unterstützt diesen Vorgang nicht.
DISP _ E _ EXCEPTION
0x80020009
Ein unerwarteter Fehler ist aufgetreten.

Hinweise

Die Mindestgröß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 oder auf eine breite festzulegen, die nicht gleichmäßig durch 8 geteilt werden kann, führen dazu, dass ein E _ INVALIDARG-Fehler zurückgegeben wird.

Anforderungen

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

Weitere Informationen

IVMDisplay