|
void | getScreenResolution (in unsigned long screenId, out unsigned long width, out unsigned long height, out unsigned long bitsPerPixel, out long xOrigin, out long yOrigin, out GuestMonitorStatus guestMonitorStatus) |
| Queries certain attributes such as display width, height, color depth and the X and Y origin for a given guest screen. More...
|
|
void | attachFramebuffer (in unsigned long screenId, in IFramebuffer framebuffer, [retval] out wstringUUID id) |
| Sets the graphics update target for a screen. More...
|
|
void | detachFramebuffer (in unsigned long screenId, in wstringUUID id) |
| Removes the graphics updates target for a screen. More...
|
|
void | queryFramebuffer (in unsigned long screenId, [retval] out IFramebuffer framebuffer) |
| Queries the graphics updates targets for a screen. More...
|
|
void | setVideoModeHint (in unsigned long display, in boolean enabled, in boolean changeOrigin, in long originX, in long originY, in unsigned long width, in unsigned long height, in unsigned long bitsPerPixel) |
| Asks VirtualBox to request the given video mode from the guest. More...
|
|
void | setSeamlessMode (in boolean enabled) |
| Enables or disables seamless guest display rendering (seamless desktop integration) mode. More...
|
|
void | takeScreenShot (in unsigned long screenId, in octetPtr address, in unsigned long width, in unsigned long height, in BitmapFormat bitmapFormat) |
| Takes a screen shot of the requested size and format and copies it to the buffer allocated by the caller and pointed to by address. More...
|
|
void | takeScreenShotToArray (in unsigned long screenId, in unsigned long width, in unsigned long height, in BitmapFormat bitmapFormat, [retval] out octet[] screenData) |
| Takes a guest screen shot of the requested size and format and returns it as an array of bytes. More...
|
|
void | drawToScreen (in unsigned long screenId, in octetPtr address, in unsigned long x, in unsigned long y, in unsigned long width, in unsigned long height) |
| Draws a 32-bpp image of the specified size from the given buffer to the given point on the VM display. More...
|
|
void | invalidateAndUpdate () |
| Does a full invalidation of the VM display and instructs the VM to update it. More...
|
|
void | invalidateAndUpdateScreen (in unsigned long screenId) |
| Redraw the specified VM screen. More...
|
|
void | completeVHWACommand (in octetPtr command) |
| Signals that the Video HW Acceleration command has completed. More...
|
|
void | viewportChanged (in unsigned long screenId, in unsigned long x, in unsigned long y, in unsigned long width, in unsigned long height) |
| Signals that framebuffer window viewport has changed. More...
|
|
void | querySourceBitmap (in unsigned long screenId, out IDisplaySourceBitmap displaySourceBitmap) |
| Obtains the guest screen bitmap parameters. More...
|
|
void | notifyScaleFactorChange (in unsigned long screenId, in unsigned long u32ScaleFactorWMultiplied, in unsigned long u32ScaleFactorHMultiplied) |
| Notify OpenGL HGCM host service about graphics content scaling factor change. More...
|
|
void | notifyHiDPIOutputPolicyChange (in boolean fUnscaledHiDPI) |
| Notify OpenGL HGCM host service about HiDPI monitor scaling policy change. More...
|
|
void | setScreenLayout (in ScreenLayoutMode screenLayoutMode, in IGuestScreenInfo[] guestScreenInfo) |
| Set video modes for the guest screens. More...
|
|
void | detachScreens (in long[] screenIds) |
| Unplugs monitors from the virtual graphics card. More...
|
|
The IDisplay interface represents the virtual machine's display.
The object implementing this interface is contained in each IConsole::display attribute and represents the visual output of the virtual machine.
The virtual display supports pluggable output targets represented by the IFramebuffer interface. Examples of the output target are a window on the host computer or an RDP session's display on a remote computer.
- Interface ID:
{76EED314-3C72-4BBB-95CF-5EB4947A4041}
void IDisplay::setVideoModeHint |
( |
in unsigned long |
display, |
|
|
in boolean |
enabled, |
|
|
in boolean |
changeOrigin, |
|
|
in long |
originX, |
|
|
in long |
originY, |
|
|
in unsigned long |
width, |
|
|
in unsigned long |
height, |
|
|
in unsigned long |
bitsPerPixel |
|
) |
| |
Asks VirtualBox to request the given video mode from the guest.
This is just a hint and it cannot be guaranteed that the requested resolution will be used. Guest Additions are required for the request to be seen by guests. The caller should issue the request and wait for a resolution change and after a timeout retry.
Specifying 0
for either width, height or bitsPerPixel parameters means that the corresponding values should be taken from the current video mode (i.e. left unchanged).
If the guest OS supports multi-monitor configuration then the display parameter specifies the number of the guest display to send the hint to: 0
is the primary display, 1
is the first secondary and so on. If the multi-monitor configuration is not supported, display must be 0
.
- Parameters
-
display | The number of the guest display to send the hint to. |
enabled | True , if this guest screen is enabled, False otherwise. |
changeOrigin | True , if the origin of the guest screen should be changed, False otherwise. |
originX | The X origin of the guest screen. |
originY | The Y origin of the guest screen. |
width | The width of the guest screen. |
height | The height of the guest screen. |
bitsPerPixel | The number of bits per pixel of the guest screen. |
- Expected result codes:
E_INVALIDARG | The display is not associated with any monitor. |