IVMDisplay::SetDimensions-Methode

  • Artikel

[Windows Virtual PC ist ab Windows 8 nicht mehr 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ächstniedrige 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 Minimalwerte (640 x 480) oder maximal 2048x1920.
VM_E_TIMED_OUT
0xA0040202
 Die Auflösungsänderung wurde nicht rechtzeitig abgeschlossen.
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 konnte nicht gefunden werden.
VM_E_ADDITIONS_FEATURE_NOT_AVAIL
0xA0040505
 Die Version der im Gastbetriebssystem installierten Integrationskomponenten unterstützt diesen Vorgang nicht.
DISP_E_EXCEPTION
0x80020009
 Ein unerwarteter Fehler ist aufgetreten.

Bemerkungen

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 teilbar ist, führen dazu, dass ein E_INVALIDARG Fehler zurückgegeben wird.

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

Weitere Informationen

IVMDisplay