[3165] | 1 | /** @file
|
---|
[21217] | 2 | * VirtualBox Video interface.
|
---|
[3165] | 3 | */
|
---|
| 4 |
|
---|
| 5 | /*
|
---|
[8155] | 6 | * Copyright (C) 2006 Sun Microsystems, Inc.
|
---|
[3165] | 7 | *
|
---|
| 8 | * This file is part of VirtualBox Open Source Edition (OSE), as
|
---|
| 9 | * available from http://www.virtualbox.org. This file is free software;
|
---|
| 10 | * you can redistribute it and/or modify it under the terms of the GNU
|
---|
[5999] | 11 | * General Public License (GPL) as published by the Free Software
|
---|
| 12 | * Foundation, in version 2 as it comes in the "COPYING" file of the
|
---|
| 13 | * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
|
---|
| 14 | * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
|
---|
| 15 | *
|
---|
| 16 | * The contents of this file may alternatively be used under the terms
|
---|
| 17 | * of the Common Development and Distribution License Version 1.0
|
---|
| 18 | * (CDDL) only, as it comes in the "COPYING.CDDL" file of the
|
---|
| 19 | * VirtualBox OSE distribution, in which case the provisions of the
|
---|
| 20 | * CDDL are applicable instead of those of the GPL.
|
---|
| 21 | *
|
---|
| 22 | * You may elect to license modified versions of this file under the
|
---|
| 23 | * terms and conditions of either the GPL or the CDDL or both.
|
---|
[8155] | 24 | *
|
---|
| 25 | * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa
|
---|
| 26 | * Clara, CA 95054 USA or visit http://www.sun.com if you need
|
---|
| 27 | * additional information or have any questions.
|
---|
[3165] | 28 | */
|
---|
| 29 |
|
---|
[3632] | 30 | #ifndef ___VBox_VBoxVideo_h
|
---|
| 31 | #define ___VBox_VBoxVideo_h
|
---|
[3165] | 32 |
|
---|
| 33 | #include <iprt/cdefs.h>
|
---|
| 34 | #include <iprt/types.h>
|
---|
| 35 |
|
---|
[18135] | 36 | /*
|
---|
[3165] | 37 | * The last 4096 bytes of the guest VRAM contains the generic info for all
|
---|
| 38 | * DualView chunks: sizes and offsets of chunks. This is filled by miniport.
|
---|
| 39 | *
|
---|
| 40 | * Last 4096 bytes of each chunk contain chunk specific data: framebuffer info,
|
---|
| 41 | * etc. This is used exclusively by the corresponding instance of a display driver.
|
---|
| 42 | *
|
---|
[18135] | 43 | * The VRAM layout:
|
---|
[4027] | 44 | * Last 4096 bytes - Adapter information area.
|
---|
| 45 | * 4096 bytes aligned miniport heap (value specified in the config rouded up).
|
---|
| 46 | * Slack - what left after dividing the VRAM.
|
---|
| 47 | * 4096 bytes aligned framebuffers:
|
---|
| 48 | * last 4096 bytes of each framebuffer is the display information area.
|
---|
| 49 | *
|
---|
[3165] | 50 | * The Virtual Graphics Adapter information in the guest VRAM is stored by the
|
---|
| 51 | * guest video driver using structures prepended by VBOXVIDEOINFOHDR.
|
---|
| 52 | *
|
---|
[4027] | 53 | * When the guest driver writes dword 0 to the VBE_DISPI_INDEX_VBOX_VIDEO
|
---|
[3165] | 54 | * the host starts to process the info. The first element at the start of
|
---|
| 55 | * the 4096 bytes region should be normally be a LINK that points to
|
---|
| 56 | * actual information chain. That way the guest driver can have some
|
---|
| 57 | * fixed layout of the information memory block and just rewrite
|
---|
| 58 | * the link to point to relevant memory chain.
|
---|
| 59 | *
|
---|
| 60 | * The processing stops at the END element.
|
---|
| 61 | *
|
---|
| 62 | * The host can access the memory only when the port IO is processed.
|
---|
| 63 | * All data that will be needed later must be copied from these 4096 bytes.
|
---|
| 64 | * But other VRAM can be used by host until the mode is disabled.
|
---|
| 65 | *
|
---|
[4027] | 66 | * The guest driver writes dword 0xffffffff to the VBE_DISPI_INDEX_VBOX_VIDEO
|
---|
[3165] | 67 | * to disable the mode.
|
---|
| 68 | *
|
---|
[4027] | 69 | * VBE_DISPI_INDEX_VBOX_VIDEO is used to read the configuration information
|
---|
| 70 | * from the host and issue commands to the host.
|
---|
[18135] | 71 | *
|
---|
[4027] | 72 | * The guest writes the VBE_DISPI_INDEX_VBOX_VIDEO index register, the the
|
---|
| 73 | * following operations with the VBE data register can be performed:
|
---|
[18135] | 74 | *
|
---|
[4027] | 75 | * Operation Result
|
---|
| 76 | * write 16 bit value NOP
|
---|
| 77 | * read 16 bit value count of monitors
|
---|
| 78 | * write 32 bit value sets the vbox command value and the command processed by the host
|
---|
| 79 | * read 32 bit value result of the last vbox command is returned
|
---|
[3165] | 80 | */
|
---|
| 81 |
|
---|
| 82 | #define VBOX_VIDEO_PRIMARY_SCREEN 0
|
---|
| 83 | #define VBOX_VIDEO_NO_SCREEN ~0
|
---|
| 84 |
|
---|
[4027] | 85 | #define VBOX_VIDEO_MAX_SCREENS 64
|
---|
[3165] | 86 |
|
---|
| 87 | /* The size of the information. */
|
---|
[17676] | 88 | #ifndef VBOX_WITH_HGSMI
|
---|
[3165] | 89 | #define VBOX_VIDEO_ADAPTER_INFORMATION_SIZE 4096
|
---|
| 90 | #define VBOX_VIDEO_DISPLAY_INFORMATION_SIZE 4096
|
---|
[17676] | 91 | #else
|
---|
| 92 | /*
|
---|
| 93 | * The minimum HGSMI heap size is PAGE_SIZE (4096 bytes) and is a restriction of the
|
---|
| 94 | * runtime heapsimple API. Use minimum 2 pages here, because the info area also may
|
---|
[18135] | 95 | * contain other data (for example HGSMIHOSTFLAGS structure).
|
---|
[17676] | 96 | */
|
---|
[18135] | 97 | #define VBVA_ADAPTER_INFORMATION_SIZE (8*_1K)
|
---|
| 98 | #define VBVA_DISPLAY_INFORMATION_SIZE (8*_1K)
|
---|
| 99 | #define VBVA_MIN_BUFFER_SIZE (64*_1K)
|
---|
[17676] | 100 | #endif /* VBOX_WITH_HGSMI */
|
---|
[3165] | 101 |
|
---|
| 102 |
|
---|
| 103 | /* The value for port IO to let the adapter to interpret the adapter memory. */
|
---|
| 104 | #define VBOX_VIDEO_DISABLE_ADAPTER_MEMORY 0xFFFFFFFF
|
---|
| 105 |
|
---|
| 106 | /* The value for port IO to let the adapter to interpret the adapter memory. */
|
---|
| 107 | #define VBOX_VIDEO_INTERPRET_ADAPTER_MEMORY 0x00000000
|
---|
| 108 |
|
---|
| 109 | /* The value for port IO to let the adapter to interpret the display memory.
|
---|
[18135] | 110 | * The display number is encoded in low 16 bits.
|
---|
[3165] | 111 | */
|
---|
| 112 | #define VBOX_VIDEO_INTERPRET_DISPLAY_MEMORY_BASE 0x00010000
|
---|
| 113 |
|
---|
[4027] | 114 |
|
---|
[3165] | 115 | /* The end of the information. */
|
---|
| 116 | #define VBOX_VIDEO_INFO_TYPE_END 0
|
---|
| 117 | /* Instructs the host to fetch the next VBOXVIDEOINFOHDR at the given offset of VRAM. */
|
---|
| 118 | #define VBOX_VIDEO_INFO_TYPE_LINK 1
|
---|
| 119 | /* Information about a display memory position. */
|
---|
| 120 | #define VBOX_VIDEO_INFO_TYPE_DISPLAY 2
|
---|
| 121 | /* Information about a screen. */
|
---|
| 122 | #define VBOX_VIDEO_INFO_TYPE_SCREEN 3
|
---|
| 123 | /* Information about host notifications for the driver. */
|
---|
| 124 | #define VBOX_VIDEO_INFO_TYPE_HOST_EVENTS 4
|
---|
[4027] | 125 | /* Information about non-volatile guest VRAM heap. */
|
---|
| 126 | #define VBOX_VIDEO_INFO_TYPE_NV_HEAP 5
|
---|
[4053] | 127 | /* VBVA enable/disable. */
|
---|
| 128 | #define VBOX_VIDEO_INFO_TYPE_VBVA_STATUS 6
|
---|
| 129 | /* VBVA flush. */
|
---|
| 130 | #define VBOX_VIDEO_INFO_TYPE_VBVA_FLUSH 7
|
---|
| 131 | /* Query configuration value. */
|
---|
| 132 | #define VBOX_VIDEO_INFO_TYPE_QUERY_CONF32 8
|
---|
[3165] | 133 |
|
---|
| 134 |
|
---|
| 135 | #pragma pack(1)
|
---|
| 136 | typedef struct _VBOXVIDEOINFOHDR
|
---|
| 137 | {
|
---|
| 138 | uint8_t u8Type;
|
---|
| 139 | uint8_t u8Reserved;
|
---|
| 140 | uint16_t u16Length;
|
---|
| 141 | } VBOXVIDEOINFOHDR;
|
---|
| 142 |
|
---|
| 143 |
|
---|
| 144 | typedef struct _VBOXVIDEOINFOLINK
|
---|
| 145 | {
|
---|
| 146 | /* Relative offset in VRAM */
|
---|
| 147 | int32_t i32Offset;
|
---|
| 148 | } VBOXVIDEOINFOLINK;
|
---|
| 149 |
|
---|
| 150 |
|
---|
| 151 | /* Resides in adapter info memory. Describes a display VRAM chunk. */
|
---|
| 152 | typedef struct _VBOXVIDEOINFODISPLAY
|
---|
| 153 | {
|
---|
| 154 | /* Index of the framebuffer assigned by guest. */
|
---|
| 155 | uint32_t u32Index;
|
---|
| 156 |
|
---|
| 157 | /* Absolute offset in VRAM of the framebuffer to be displayed on the monitor. */
|
---|
| 158 | uint32_t u32Offset;
|
---|
| 159 |
|
---|
| 160 | /* The size of the memory that can be used for the screen. */
|
---|
| 161 | uint32_t u32FramebufferSize;
|
---|
| 162 |
|
---|
| 163 | /* The size of the memory that is used for the Display information.
|
---|
| 164 | * The information is at u32Offset + u32FramebufferSize
|
---|
| 165 | */
|
---|
| 166 | uint32_t u32InformationSize;
|
---|
| 167 |
|
---|
| 168 | } VBOXVIDEOINFODISPLAY;
|
---|
| 169 |
|
---|
| 170 |
|
---|
| 171 | /* Resides in display info area, describes the current video mode. */
|
---|
| 172 | #define VBOX_VIDEO_INFO_SCREEN_F_NONE 0x00
|
---|
| 173 | #define VBOX_VIDEO_INFO_SCREEN_F_ACTIVE 0x01
|
---|
| 174 |
|
---|
| 175 | typedef struct _VBOXVIDEOINFOSCREEN
|
---|
| 176 | {
|
---|
| 177 | /* Physical X origin relative to the primary screen. */
|
---|
| 178 | int32_t xOrigin;
|
---|
| 179 |
|
---|
| 180 | /* Physical Y origin relative to the primary screen. */
|
---|
| 181 | int32_t yOrigin;
|
---|
| 182 |
|
---|
| 183 | /* The scan line size in bytes. */
|
---|
| 184 | uint32_t u32LineSize;
|
---|
| 185 |
|
---|
| 186 | /* Width of the screen. */
|
---|
| 187 | uint16_t u16Width;
|
---|
| 188 |
|
---|
| 189 | /* Height of the screen. */
|
---|
| 190 | uint16_t u16Height;
|
---|
| 191 |
|
---|
| 192 | /* Color depth. */
|
---|
| 193 | uint8_t bitsPerPixel;
|
---|
| 194 |
|
---|
| 195 | /* VBOX_VIDEO_INFO_SCREEN_F_* */
|
---|
| 196 | uint8_t u8Flags;
|
---|
| 197 | } VBOXVIDEOINFOSCREEN;
|
---|
| 198 |
|
---|
| 199 | /* The guest initializes the structure to 0. The positions of the structure in the
|
---|
| 200 | * display info area must not be changed, host will update the structure. Guest checks
|
---|
| 201 | * the events and modifies the structure as a response to host.
|
---|
| 202 | */
|
---|
| 203 | #define VBOX_VIDEO_INFO_HOST_EVENTS_F_NONE 0x00000000
|
---|
| 204 | #define VBOX_VIDEO_INFO_HOST_EVENTS_F_VRDP_RESET 0x00000080
|
---|
| 205 |
|
---|
| 206 | typedef struct _VBOXVIDEOINFOHOSTEVENTS
|
---|
| 207 | {
|
---|
| 208 | /* Host events. */
|
---|
| 209 | uint32_t fu32Events;
|
---|
| 210 | } VBOXVIDEOINFOHOSTEVENTS;
|
---|
[4027] | 211 |
|
---|
| 212 | /* Resides in adapter info memory. Describes the non-volatile VRAM heap. */
|
---|
| 213 | typedef struct _VBOXVIDEOINFONVHEAP
|
---|
| 214 | {
|
---|
| 215 | /* Absolute offset in VRAM of the start of the heap. */
|
---|
| 216 | uint32_t u32HeapOffset;
|
---|
| 217 |
|
---|
| 218 | /* The size of the heap. */
|
---|
| 219 | uint32_t u32HeapSize;
|
---|
| 220 |
|
---|
| 221 | } VBOXVIDEOINFONVHEAP;
|
---|
[4053] | 222 |
|
---|
| 223 | /* Display information area. */
|
---|
| 224 | typedef struct _VBOXVIDEOINFOVBVASTATUS
|
---|
| 225 | {
|
---|
| 226 | /* Absolute offset in VRAM of the start of the VBVA QUEUE. 0 to disable VBVA. */
|
---|
| 227 | uint32_t u32QueueOffset;
|
---|
| 228 |
|
---|
| 229 | /* The size of the VBVA QUEUE. 0 to disable VBVA. */
|
---|
| 230 | uint32_t u32QueueSize;
|
---|
| 231 |
|
---|
| 232 | } VBOXVIDEOINFOVBVASTATUS;
|
---|
| 233 |
|
---|
| 234 | typedef struct _VBOXVIDEOINFOVBVAFLUSH
|
---|
| 235 | {
|
---|
| 236 | uint32_t u32DataStart;
|
---|
| 237 |
|
---|
| 238 | uint32_t u32DataEnd;
|
---|
| 239 |
|
---|
| 240 | } VBOXVIDEOINFOVBVAFLUSH;
|
---|
| 241 |
|
---|
| 242 | #define VBOX_VIDEO_QCI32_MONITOR_COUNT 0
|
---|
| 243 | #define VBOX_VIDEO_QCI32_OFFSCREEN_HEAP_SIZE 1
|
---|
| 244 |
|
---|
| 245 | typedef struct _VBOXVIDEOINFOQUERYCONF32
|
---|
| 246 | {
|
---|
| 247 | uint32_t u32Index;
|
---|
| 248 |
|
---|
| 249 | uint32_t u32Value;
|
---|
| 250 |
|
---|
| 251 | } VBOXVIDEOINFOQUERYCONF32;
|
---|
[3165] | 252 | #pragma pack()
|
---|
| 253 |
|
---|
[19844] | 254 | # ifdef VBOX_WITH_VIDEOHWACCEL
|
---|
| 255 | #pragma pack(1)
|
---|
| 256 |
|
---|
| 257 | typedef enum
|
---|
| 258 | {
|
---|
[20478] | 259 | VBOXVHWACMD_TYPE_SURF_CANCREATE = 1,
|
---|
| 260 | VBOXVHWACMD_TYPE_SURF_CREATE,
|
---|
[20243] | 261 | VBOXVHWACMD_TYPE_SURF_DESTROY,
|
---|
| 262 | VBOXVHWACMD_TYPE_SURF_LOCK,
|
---|
| 263 | VBOXVHWACMD_TYPE_SURF_UNLOCK,
|
---|
[20478] | 264 | VBOXVHWACMD_TYPE_SURF_BLT,
|
---|
[20906] | 265 | VBOXVHWACMD_TYPE_SURF_FLIP,
|
---|
| 266 | VBOXVHWACMD_TYPE_SURF_OVERLAY_UPDATE,
|
---|
| 267 | VBOXVHWACMD_TYPE_SURF_OVERLAY_SETPOSITION,
|
---|
[20478] | 268 | VBOXVHWACMD_TYPE_QUERY_INFO1,
|
---|
[20653] | 269 | VBOXVHWACMD_TYPE_QUERY_INFO2,
|
---|
| 270 | VBOXVHWACMD_TYPE_ENABLE,
|
---|
| 271 | VBOXVHWACMD_TYPE_DISABLE
|
---|
[19844] | 272 | } VBOXVHWACMD_TYPE;
|
---|
| 273 |
|
---|
[20478] | 274 | /* the command processing was asynch, set by the host to indicate asynch command completion
|
---|
| 275 | * must not be cleared once set, the command completion is performed by issuing a host->guest completion command
|
---|
| 276 | * while keeping this flag unchanged */
|
---|
| 277 | #define VBOXVHWACMD_FLAG_ASYNCH 0x00000001
|
---|
| 278 | /* asynch completion is performed by issuing the event */
|
---|
| 279 | #define VBOXVHWACMD_FLAG_ASYNCH_EVENT 0x00000002
|
---|
| 280 |
|
---|
[19844] | 281 | typedef struct _VBOXVHWACMD
|
---|
| 282 | {
|
---|
| 283 | VBOXVHWACMD_TYPE enmCmd; /* command type */
|
---|
[20478] | 284 | volatile int32_t rc; /* command result */
|
---|
[19844] | 285 | int32_t iDisplay; /* display index */
|
---|
[20478] | 286 | volatile int32_t Flags; /* ored VBOXVHWACMD_FLAG_xxx values */
|
---|
[20009] | 287 | uint64_t GuestVBVAReserved1; /* field internally used by the guest VBVA cmd handling, must NOT be modified by clients */
|
---|
| 288 | uint64_t GuestVBVAReserved2; /* field internally used by the guest VBVA cmd handling, must NOT be modified by clients */
|
---|
[20653] | 289 | union
|
---|
| 290 | {
|
---|
| 291 | struct _VBOXVHWACMD *pNext;
|
---|
| 292 | uint32_t offNext;
|
---|
| 293 | uint64_t Data; /* the body is 64-bit aligned */
|
---|
| 294 | } u;
|
---|
[19844] | 295 | char body[1];
|
---|
| 296 | } VBOXVHWACMD;
|
---|
| 297 |
|
---|
[20478] | 298 | #define VBOXVHWACMD_HEADSIZE() (RT_OFFSETOF(VBOXVHWACMD, body))
|
---|
| 299 | #define VBOXVHWACMD_SIZE(_tCmd) (VBOXVHWACMD_HEADSIZE() + sizeof(_tCmd))
|
---|
[19844] | 300 | typedef unsigned int VBOXVHWACMD_LENGTH;
|
---|
| 301 | typedef uint64_t VBOXVHWA_SURFHANDLE;
|
---|
| 302 | #define VBOXVHWACMD_SURFHANDLE_INVALID 0
|
---|
| 303 | #define VBOXVHWACMD_BODY(_p, _t) ((_t*)(_p)->body)
|
---|
[20478] | 304 | #define VBOXVHWACMD_HEAD(_pb) ((VBOXVHWACMD*)((uint8_t *)(_pb) - RT_OFFSETOF(VBOXVHWACMD, body)))
|
---|
[19844] | 305 |
|
---|
| 306 | typedef struct _VBOXVHWA_RECTL
|
---|
| 307 | {
|
---|
[20483] | 308 | int32_t x;
|
---|
| 309 | int32_t y;
|
---|
| 310 | uint32_t w;
|
---|
| 311 | uint32_t h;
|
---|
[19844] | 312 | } VBOXVHWA_RECTL;
|
---|
| 313 |
|
---|
[20243] | 314 | typedef struct _VBOXVHWA_COLORKEY
|
---|
| 315 | {
|
---|
| 316 | uint32_t low;
|
---|
| 317 | uint32_t high;
|
---|
| 318 | } VBOXVHWA_COLORKEY;
|
---|
| 319 |
|
---|
| 320 | typedef struct _VBOXVHWA_PIXELFORMAT
|
---|
| 321 | {
|
---|
| 322 | uint32_t flags;
|
---|
| 323 | uint32_t fourCC;
|
---|
| 324 | union
|
---|
| 325 | {
|
---|
| 326 | uint32_t rgbBitCount;
|
---|
| 327 | uint32_t yuvBitCount;
|
---|
| 328 | } c;
|
---|
| 329 |
|
---|
| 330 | union
|
---|
| 331 | {
|
---|
| 332 | uint32_t rgbRBitMask;
|
---|
| 333 | uint32_t yuvYBitMask;
|
---|
| 334 | } m1;
|
---|
| 335 |
|
---|
| 336 | union
|
---|
| 337 | {
|
---|
| 338 | uint32_t rgbGBitMask;
|
---|
| 339 | uint32_t yuvUBitMask;
|
---|
| 340 | } m2;
|
---|
| 341 |
|
---|
| 342 | union
|
---|
| 343 | {
|
---|
| 344 | uint32_t rgbBBitMask;
|
---|
| 345 | uint32_t yuvVBitMask;
|
---|
| 346 | } m3;
|
---|
| 347 | } VBOXVHWA_PIXELFORMAT;
|
---|
| 348 |
|
---|
[20683] | 349 | typedef struct _VBOXVHWA_SURFACEDESC
|
---|
[19844] | 350 | {
|
---|
[20683] | 351 | uint32_t flags;
|
---|
[20243] | 352 | uint32_t height;
|
---|
| 353 | uint32_t width;
|
---|
[20683] | 354 | uint32_t pitch;
|
---|
| 355 | uint32_t cBackBuffers;
|
---|
| 356 | uint32_t Reserved1;
|
---|
[20243] | 357 | VBOXVHWA_COLORKEY DstOverlayCK;
|
---|
| 358 | VBOXVHWA_COLORKEY DstBltCK;
|
---|
| 359 | VBOXVHWA_COLORKEY SrcOverlayCK;
|
---|
| 360 | VBOXVHWA_COLORKEY SrcBltCK;
|
---|
| 361 | VBOXVHWA_PIXELFORMAT PixelFormat;
|
---|
| 362 | uint32_t surfCaps;
|
---|
[20683] | 363 | uint32_t Reserved2;
|
---|
| 364 | } VBOXVHWA_SURFACEDESC;
|
---|
[19844] | 365 |
|
---|
[20985] | 366 | typedef struct _VBOXVHWA_BLTFX
|
---|
[20906] | 367 | {
|
---|
| 368 | uint32_t flags;
|
---|
| 369 | uint32_t rop;
|
---|
| 370 | uint32_t rotationOp;
|
---|
| 371 | uint32_t rotation;
|
---|
[20985] | 372 | uint32_t fillColor;
|
---|
| 373 | uint32_t Reserved;
|
---|
[20906] | 374 | VBOXVHWA_COLORKEY DstCK;
|
---|
| 375 | VBOXVHWA_COLORKEY SrcCK;
|
---|
[20985] | 376 | } VBOXVHWA_BLTFX;
|
---|
[20906] | 377 |
|
---|
[20985] | 378 | typedef struct _VBOXVHWA_OVERLAYFX
|
---|
[20906] | 379 | {
|
---|
| 380 | uint32_t flags;
|
---|
| 381 | uint32_t Reserved1;
|
---|
| 382 | uint32_t rotationOp;
|
---|
| 383 | uint32_t Reserved2;
|
---|
| 384 | VBOXVHWA_COLORKEY DstCK;
|
---|
| 385 | VBOXVHWA_COLORKEY SrcCK;
|
---|
[20985] | 386 | } VBOXVHWA_OVERLAYFX;
|
---|
[20906] | 387 |
|
---|
[20478] | 388 | #define VBOXVHWA_CAPS_BLT 0x00000001
|
---|
| 389 | #define VBOXVHWA_CAPS_BLTCOLORFILL 0x00000002
|
---|
| 390 | #define VBOXVHWA_CAPS_BLTFOURCC 0x00000004
|
---|
| 391 | #define VBOXVHWA_CAPS_BLTSTRETCH 0x00000008
|
---|
[20985] | 392 | #define VBOXVHWA_CAPS_BLTQUEUE 0x00000010
|
---|
[20478] | 393 |
|
---|
| 394 | #define VBOXVHWA_CAPS_OVERLAY 0x00000100
|
---|
| 395 | #define VBOXVHWA_CAPS_OVERLAYFOURCC 0x00000200
|
---|
| 396 | #define VBOXVHWA_CAPS_OVERLAYSTRETCH 0x00000400
|
---|
| 397 |
|
---|
[20985] | 398 | #define VBOXVHWA_CAPS_COLORKEY 0x00010000
|
---|
| 399 | #define VBOXVHWA_CAPS_COLORKEYHWASSIST 0x00020000
|
---|
[20478] | 400 |
|
---|
[20985] | 401 |
|
---|
[20478] | 402 | #define VBOXVHWA_CAPS2_COPYFOURCC 0x00000001
|
---|
| 403 |
|
---|
| 404 | #define VBOXVHWA_SCAPS_FLIP 0x00000001
|
---|
| 405 | #define VBOXVHWA_SCAPS_PRIMARYSURFACE 0x00000002
|
---|
[20985] | 406 | #define VBOXVHWA_SCAPS_OFFSCREENPLAIN 0x00000004
|
---|
[20478] | 407 | #define VBOXVHWA_SCAPS_OVERLAY 0x00000008
|
---|
[20985] | 408 | #define VBOXVHWA_SCAPS_VISIBLE 0x00000010
|
---|
| 409 | #define VBOXVHWA_SCAPS_VIDEOMEMORY 0x00000020
|
---|
| 410 | #define VBOXVHWA_SCAPS_LOCALVIDMEM 0x00000040
|
---|
[20478] | 411 |
|
---|
[20985] | 412 |
|
---|
[20478] | 413 | #define VBOXVHWA_PF_RGB 0x00000001
|
---|
| 414 | #define VBOXVHWA_PF_RGBTOYUV 0x00000002
|
---|
| 415 | #define VBOXVHWA_PF_YUV 0x00000008
|
---|
| 416 | #define VBOXVHWA_PF_FOURCC 0x00000010
|
---|
| 417 |
|
---|
[20653] | 418 | #define VBOXVHWA_LOCK_DISCARDCONTENTS 0x00000001
|
---|
| 419 |
|
---|
[20683] | 420 | #define VBOXVHWA_CFG_ENABLED 0x00000001
|
---|
[20478] | 421 |
|
---|
[20683] | 422 | #define VBOXVHWA_SD_BACKBUFFERCOUNT 0x00000001
|
---|
| 423 | #define VBOXVHWA_SD_CAPS 0x00000002
|
---|
| 424 | #define VBOXVHWA_SD_CKDESTBLT 0x00000004
|
---|
| 425 | #define VBOXVHWA_SD_CKDESTOVERLAY 0x00000008
|
---|
| 426 | #define VBOXVHWA_SD_CKSRCBLT 0x00000010
|
---|
| 427 | #define VBOXVHWA_SD_CKSRCOVERLAY 0x00000020
|
---|
| 428 | #define VBOXVHWA_SD_HEIGHT 0x00000040
|
---|
| 429 | #define VBOXVHWA_SD_PITCH 0x00000080
|
---|
| 430 | #define VBOXVHWA_SD_PIXELFORMAT 0x00000100
|
---|
| 431 | //#define VBOXVHWA_SD_REFRESHRATE 0x00000200
|
---|
| 432 | #define VBOXVHWA_SD_WIDTH 0x00000400
|
---|
| 433 |
|
---|
[20985] | 434 | #define VBOXVHWA_CKEYCAPS_DESTBLT 0x00000001
|
---|
| 435 | #define VBOXVHWA_CKEYCAPS_DESTBLTCLRSPACE 0x00000002
|
---|
| 436 | #define VBOXVHWA_CKEYCAPS_DESTBLTCLRSPACEYUV 0x00000004
|
---|
| 437 | #define VBOXVHWA_CKEYCAPS_DESTBLTYUV 0x00000008
|
---|
| 438 | #define VBOXVHWA_CKEYCAPS_DESTOVERLAY 0x00000010
|
---|
| 439 | #define VBOXVHWA_CKEYCAPS_DESTOVERLAYCLRSPACE 0x00000020
|
---|
| 440 | #define VBOXVHWA_CKEYCAPS_DESTOVERLAYCLRSPACEYUV 0x00000040
|
---|
| 441 | #define VBOXVHWA_CKEYCAPS_DESTOVERLAYONEACTIVE 0x00000080
|
---|
| 442 | #define VBOXVHWA_CKEYCAPS_DESTOVERLAYYUV 0x00000100
|
---|
| 443 | #define VBOXVHWA_CKEYCAPS_NOCOSTOVERLAY 0x00000200
|
---|
| 444 | #define VBOXVHWA_CKEYCAPS_SRCBLT 0x00000400
|
---|
| 445 | #define VBOXVHWA_CKEYCAPS_SRCBLTCLRSPACE 0x00000800
|
---|
| 446 | #define VBOXVHWA_CKEYCAPS_SRCBLTCLRSPACEYUV 0x00001000
|
---|
| 447 | #define VBOXVHWA_CKEYCAPS_SRCBLTYUV 0x00002000
|
---|
| 448 | #define VBOXVHWA_CKEYCAPS_SRCOVERLAY 0x00004000
|
---|
| 449 | #define VBOXVHWA_CKEYCAPS_SRCOVERLAYCLRSPACE 0x00008000
|
---|
| 450 | #define VBOXVHWA_CKEYCAPS_SRCOVERLAYCLRSPACEYUV 0x00010000
|
---|
| 451 | #define VBOXVHWA_CKEYCAPS_SRCOVERLAYONEACTIVE 0x00020000
|
---|
| 452 | #define VBOXVHWA_CKEYCAPS_SRCOVERLAYYUV 0x00040000
|
---|
[20683] | 453 |
|
---|
[20985] | 454 |
|
---|
| 455 | #define VBOXVHWA_BLT_COLORFILL 0x00000400
|
---|
| 456 | #define VBOXVHWA_BLT_DDFX 0x00000800
|
---|
| 457 | #define VBOXVHWA_BLT_EXTENDED_FLAGS 0x40000000
|
---|
| 458 | #define VBOXVHWA_BLT_EXTENDED_LINEAR_CONTENT 0x00000004
|
---|
| 459 | #define VBOXVHWA_BLT_EXTENDED_PRESENTATION_STRETCHFACTOR 0x00000010
|
---|
| 460 | #define VBOXVHWA_BLT_KEYDESTOVERRIDE 0x00004000
|
---|
| 461 | #define VBOXVHWA_BLT_KEYSRCOVERRIDE 0x00010000
|
---|
| 462 | #define VBOXVHWA_BLT_LAST_PRESENTATION 0x20000000
|
---|
| 463 | #define VBOXVHWA_BLT_PRESENTATION 0x10000000
|
---|
| 464 | #define VBOXVHWA_BLT_ROP 0x00020000
|
---|
| 465 |
|
---|
| 466 |
|
---|
| 467 |
|
---|
| 468 |
|
---|
[20653] | 469 | #define VBOXVHWA_OFFSET64_VOID (~0L)
|
---|
| 470 |
|
---|
[20478] | 471 | typedef struct _VBOXVHWACMD_QUERYINFO1
|
---|
| 472 | {
|
---|
| 473 | uint32_t cfgFlags;
|
---|
| 474 | uint32_t caps;
|
---|
| 475 | uint32_t colorKeyCaps;
|
---|
| 476 | uint32_t stretchCaps;
|
---|
| 477 | uint32_t surfaceCaps;
|
---|
| 478 | uint32_t numOverlays;
|
---|
| 479 | uint32_t numFourCC;
|
---|
| 480 |
|
---|
| 481 | } VBOXVHWACMD_QUERYINFO1;
|
---|
| 482 |
|
---|
| 483 | typedef struct _VBOXVHWACMD_QUERYINFO2
|
---|
| 484 | {
|
---|
| 485 | uint32_t numFourCC;
|
---|
| 486 | uint32_t FourCC[1];
|
---|
| 487 | } VBOXVHWACMD_QUERYINFO2;
|
---|
| 488 |
|
---|
| 489 | #define VBOXVHWAINFO2_SIZE(_cFourCC) RT_OFFSETOF(VBOXVHWAINFO2, FourCC[_cFourCC])
|
---|
| 490 |
|
---|
| 491 | typedef struct _VBOXVHWACMD_SURF_CANCREATE
|
---|
| 492 | {
|
---|
| 493 | union
|
---|
| 494 | {
|
---|
| 495 | struct
|
---|
| 496 | {
|
---|
[20683] | 497 | VBOXVHWA_SURFACEDESC SurfInfo;
|
---|
| 498 | uint32_t bIsDifferentPixelFormat;
|
---|
| 499 | uint32_t Reserved;
|
---|
[20478] | 500 | } in;
|
---|
| 501 |
|
---|
| 502 | struct
|
---|
| 503 | {
|
---|
| 504 | uint32_t ErrInfo;
|
---|
| 505 | } out;
|
---|
| 506 | } u;
|
---|
| 507 | } VBOXVHWACMD_SURF_CANCREATE;
|
---|
| 508 |
|
---|
[19844] | 509 | typedef struct _VBOXVHWACMD_SURF_CREATE
|
---|
| 510 | {
|
---|
| 511 | union
|
---|
| 512 | {
|
---|
| 513 | struct
|
---|
| 514 | {
|
---|
[20683] | 515 | VBOXVHWA_SURFACEDESC SurfInfo;
|
---|
[20653] | 516 | uint64_t offSurface;
|
---|
[19844] | 517 | } in;
|
---|
| 518 |
|
---|
| 519 | struct
|
---|
| 520 | {
|
---|
| 521 | VBOXVHWA_SURFHANDLE hSurf;
|
---|
| 522 | } out;
|
---|
| 523 | } u;
|
---|
| 524 | } VBOXVHWACMD_SURF_CREATE;
|
---|
| 525 |
|
---|
| 526 | typedef struct _VBOXVHWACMD_SURF_DESTROY
|
---|
| 527 | {
|
---|
| 528 | union
|
---|
| 529 | {
|
---|
| 530 | struct
|
---|
| 531 | {
|
---|
| 532 | VBOXVHWA_SURFHANDLE hSurf;
|
---|
| 533 | } in;
|
---|
| 534 | } u;
|
---|
| 535 | } VBOXVHWACMD_SURF_DESTROY;
|
---|
[20243] | 536 |
|
---|
| 537 | typedef struct _VBOXVHWACMD_SURF_LOCK
|
---|
| 538 | {
|
---|
| 539 | union
|
---|
| 540 | {
|
---|
| 541 | struct
|
---|
| 542 | {
|
---|
| 543 | VBOXVHWA_SURFHANDLE hSurf;
|
---|
[20653] | 544 | uint64_t offSurface;
|
---|
[20243] | 545 | uint32_t flags;
|
---|
[20653] | 546 | uint32_t rectValid;
|
---|
[20243] | 547 | VBOXVHWA_RECTL rect;
|
---|
| 548 | } in;
|
---|
| 549 | } u;
|
---|
| 550 | } VBOXVHWACMD_SURF_LOCK;
|
---|
| 551 |
|
---|
| 552 | typedef struct _VBOXVHWACMD_SURF_UNLOCK
|
---|
| 553 | {
|
---|
| 554 | union
|
---|
| 555 | {
|
---|
| 556 | struct
|
---|
| 557 | {
|
---|
| 558 | VBOXVHWA_SURFHANDLE hSurf;
|
---|
| 559 | } in;
|
---|
| 560 | } u;
|
---|
| 561 | } VBOXVHWACMD_SURF_UNLOCK;
|
---|
| 562 |
|
---|
| 563 | typedef struct _VBOXVHWACMD_SURF_BLT
|
---|
| 564 | {
|
---|
[20483] | 565 | uint64_t DstGuestSurfInfo;
|
---|
| 566 | uint64_t SrcGuestSurfInfo;
|
---|
[20243] | 567 | union
|
---|
| 568 | {
|
---|
| 569 | struct
|
---|
| 570 | {
|
---|
| 571 | VBOXVHWA_SURFHANDLE hDstSurf;
|
---|
[20653] | 572 | uint64_t offDstSurface;
|
---|
[20243] | 573 | VBOXVHWA_RECTL dstRect;
|
---|
| 574 | VBOXVHWA_SURFHANDLE hSrcSurf;
|
---|
[20653] | 575 | uint64_t offSrcSurface;
|
---|
[20243] | 576 | VBOXVHWA_RECTL srcRect;
|
---|
| 577 | uint32_t flags;
|
---|
| 578 | uint32_t reserved;
|
---|
[20985] | 579 | VBOXVHWA_BLTFX desc;
|
---|
[20243] | 580 | } in;
|
---|
| 581 | } u;
|
---|
| 582 | } VBOXVHWACMD_SURF_BLT;
|
---|
| 583 |
|
---|
[20906] | 584 | typedef struct _VBOXVHWACMD_SURF_OVERLAY_UPDATE
|
---|
| 585 | {
|
---|
| 586 | union
|
---|
| 587 | {
|
---|
| 588 | struct
|
---|
| 589 | {
|
---|
| 590 | VBOXVHWA_SURFHANDLE hDstSurf;
|
---|
| 591 | uint64_t offDstSurface;
|
---|
| 592 | VBOXVHWA_RECTL dstRect;
|
---|
| 593 | VBOXVHWA_SURFHANDLE hSrcSurf;
|
---|
| 594 | uint64_t offSrcSurface;
|
---|
| 595 | VBOXVHWA_RECTL srcRect;
|
---|
| 596 | uint32_t flags;
|
---|
| 597 | uint32_t reserved;
|
---|
[20985] | 598 | VBOXVHWA_OVERLAYFX desc;
|
---|
[20906] | 599 | } in;
|
---|
| 600 | } u;
|
---|
| 601 | }VBOXVHWACMD_SURF_OVERLAY_UPDATE;
|
---|
| 602 |
|
---|
| 603 | typedef struct _VBOXVHWACMD_SURF_OVERLAY_SETPOSITION
|
---|
| 604 | {
|
---|
| 605 | union
|
---|
| 606 | {
|
---|
| 607 | struct
|
---|
| 608 | {
|
---|
| 609 | VBOXVHWA_SURFHANDLE hDstSurf;
|
---|
| 610 | uint64_t offDstSurface;
|
---|
| 611 | VBOXVHWA_SURFHANDLE hSrcSurf;
|
---|
| 612 | uint64_t offSrcSurface;
|
---|
| 613 | uint32_t xPos;
|
---|
| 614 | uint32_t yPos;
|
---|
| 615 | uint32_t flags;
|
---|
| 616 | uint32_t reserved;
|
---|
| 617 | } in;
|
---|
| 618 | } u;
|
---|
| 619 | } VBOXVHWACMD_SURF_OVERLAY_SETPOSITION;
|
---|
| 620 |
|
---|
[19844] | 621 | #pragma pack()
|
---|
| 622 | # endif /* #ifdef VBOX_WITH_VIDEOHWACCEL */
|
---|
| 623 |
|
---|
[17624] | 624 | #ifdef VBOX_WITH_HGSMI
|
---|
| 625 |
|
---|
| 626 | /* All structures are without alignment. */
|
---|
| 627 | #pragma pack(1)
|
---|
| 628 |
|
---|
| 629 | typedef struct _VBVABUFFER
|
---|
| 630 | {
|
---|
| 631 | uint32_t u32HostEvents;
|
---|
| 632 | uint32_t u32SupportedOrders;
|
---|
| 633 |
|
---|
| 634 | /* The offset where the data start in the buffer. */
|
---|
| 635 | uint32_t off32Data;
|
---|
| 636 | /* The offset where next data must be placed in the buffer. */
|
---|
| 637 | uint32_t off32Free;
|
---|
| 638 |
|
---|
| 639 | /* The queue of record descriptions. */
|
---|
| 640 | VBVARECORD aRecords[VBVA_MAX_RECORDS];
|
---|
| 641 | uint32_t indexRecordFirst;
|
---|
| 642 | uint32_t indexRecordFree;
|
---|
| 643 |
|
---|
| 644 | /* Space to leave free in the buffer when large partial records are transferred. */
|
---|
| 645 | uint32_t cbPartialWriteThreshold;
|
---|
| 646 |
|
---|
| 647 | uint32_t cbData;
|
---|
| 648 | uint8_t au8Data[1]; /* variable size for the rest of the VBVABUFFER area in VRAM. */
|
---|
| 649 | } VBVABUFFER;
|
---|
| 650 |
|
---|
[19844] | 651 | /* guest->host commands */
|
---|
[17624] | 652 | #define VBVA_QUERY_CONF32 1
|
---|
| 653 | #define VBVA_SET_CONF32 2
|
---|
| 654 | #define VBVA_INFO_VIEW 3
|
---|
| 655 | #define VBVA_INFO_HEAP 4
|
---|
| 656 | #define VBVA_FLUSH 5
|
---|
| 657 | #define VBVA_INFO_SCREEN 6
|
---|
| 658 | #define VBVA_ENABLE 7
|
---|
[19431] | 659 | #define VBVA_MOUSE_POINTER_SHAPE 8
|
---|
[20478] | 660 | #ifdef VBOX_WITH_VIDEOHWACCEL
|
---|
| 661 | # define VBVA_VHWA_CMD 9
|
---|
| 662 | #endif /* # ifdef VBOX_WITH_VIDEOHWACCEL */
|
---|
[17624] | 663 |
|
---|
[19844] | 664 | /* host->guest commands */
|
---|
[20478] | 665 | # define VBVAHG_EVENT 1
|
---|
| 666 | # define VBVAHG_DISPLAY_CUSTOM 2
|
---|
| 667 |
|
---|
[19844] | 668 | # ifdef VBOX_WITH_VIDEOHWACCEL
|
---|
[20478] | 669 | #define VBVAHG_DCUSTOM_VHWA_CMDCOMPLETE 1
|
---|
| 670 | #pragma pack(1)
|
---|
[19844] | 671 | typedef struct _VBVAHOSTCMDVHWACMDCOMPLETE
|
---|
[19464] | 672 | {
|
---|
[19844] | 673 | uint32_t offCmd;
|
---|
| 674 | }VBVAHOSTCMDVHWACMDCOMPLETE;
|
---|
[20478] | 675 | #pragma pack()
|
---|
[19844] | 676 | # endif /* # ifdef VBOX_WITH_VIDEOHWACCEL */
|
---|
[19464] | 677 |
|
---|
[19844] | 678 | #pragma pack(1)
|
---|
[20478] | 679 | typedef enum
|
---|
| 680 | {
|
---|
| 681 | VBVAHOSTCMD_OP_EVENT = 1,
|
---|
| 682 | VBVAHOSTCMD_OP_CUSTOM
|
---|
| 683 | }VBVAHOSTCMD_OP_TYPE;
|
---|
| 684 |
|
---|
| 685 | typedef struct _VBVAHOSTCMDEVENT
|
---|
| 686 | {
|
---|
| 687 | uint64_t pEvent;
|
---|
| 688 | }VBVAHOSTCMDEVENT;
|
---|
| 689 |
|
---|
| 690 |
|
---|
[19844] | 691 | typedef struct _VBVAHOSTCMD
|
---|
[19464] | 692 | {
|
---|
[19844] | 693 | /* destination ID if >=0 specifies display index, otherwize the command is directed to the miniport */
|
---|
| 694 | int32_t iDstID;
|
---|
[20478] | 695 | int32_t customOpCode;
|
---|
| 696 | union
|
---|
| 697 | {
|
---|
| 698 | struct _VBVAHOSTCMD *pNext;
|
---|
[20653] | 699 | uint32_t offNext;
|
---|
| 700 | uint64_t Data; /* the body is 64-bit aligned */
|
---|
[20478] | 701 | } u;
|
---|
[19464] | 702 | char body[1];
|
---|
[19844] | 703 | }VBVAHOSTCMD;
|
---|
[19464] | 704 |
|
---|
[19844] | 705 | #define VBVAHOSTCMD_SIZE(_size) (sizeof(VBVAHOSTCMD) + (_size))
|
---|
| 706 | #define VBVAHOSTCMD_BODY(_pCmd, _tBody) ((_tBody*)(_pCmd)->body)
|
---|
| 707 | #define VBVAHOSTCMD_HDR(_pBody) ((VBVAHOSTCMD*)(((uint8_t*)_pBody) - RT_OFFSETOF(VBVAHOSTCMD, body)))
|
---|
| 708 | #define VBVAHOSTCMD_HDRSIZE (RT_OFFSETOF(VBVAHOSTCMD, body))
|
---|
[19464] | 709 |
|
---|
[19844] | 710 | #pragma pack()
|
---|
[19464] | 711 |
|
---|
[17624] | 712 | /* VBVACONF32::u32Index */
|
---|
| 713 | #define VBOX_VBVA_CONF32_MONITOR_COUNT 0
|
---|
| 714 | #define VBOX_VBVA_CONF32_HOST_HEAP_SIZE 1
|
---|
| 715 |
|
---|
| 716 | typedef struct _VBVACONF32
|
---|
| 717 | {
|
---|
| 718 | uint32_t u32Index;
|
---|
| 719 | uint32_t u32Value;
|
---|
| 720 | } VBVACONF32;
|
---|
| 721 |
|
---|
| 722 | typedef struct _VBVAINFOVIEW
|
---|
| 723 | {
|
---|
| 724 | /* Index of the screen, assigned by the guest. */
|
---|
| 725 | uint32_t u32ViewIndex;
|
---|
| 726 |
|
---|
| 727 | /* The screen offset in VRAM, the framebuffer starts here. */
|
---|
| 728 | uint32_t u32ViewOffset;
|
---|
| 729 |
|
---|
[17705] | 730 | /* The size of the VRAM memory that can be used for the view. */
|
---|
[17624] | 731 | uint32_t u32ViewSize;
|
---|
| 732 |
|
---|
[17705] | 733 | /* The recommended maximum size of the VRAM memory for the screen. */
|
---|
| 734 | uint32_t u32MaxScreenSize;
|
---|
[17624] | 735 | } VBVAINFOVIEW;
|
---|
| 736 |
|
---|
| 737 | typedef struct _VBVAINFOHEAP
|
---|
| 738 | {
|
---|
| 739 | /* Absolute offset in VRAM of the start of the heap. */
|
---|
| 740 | uint32_t u32HeapOffset;
|
---|
| 741 |
|
---|
| 742 | /* The size of the heap. */
|
---|
| 743 | uint32_t u32HeapSize;
|
---|
| 744 |
|
---|
| 745 | } VBVAINFOHEAP;
|
---|
| 746 |
|
---|
| 747 | typedef struct _VBVAFLUSH
|
---|
| 748 | {
|
---|
| 749 | uint32_t u32Reserved;
|
---|
| 750 |
|
---|
| 751 | } VBVAFLUSH;
|
---|
| 752 |
|
---|
| 753 | /* VBVAINFOSCREEN::u8Flags */
|
---|
| 754 | #define VBVA_SCREEN_F_NONE 0x0000
|
---|
| 755 | #define VBVA_SCREEN_F_ACTIVE 0x0001
|
---|
| 756 |
|
---|
| 757 | typedef struct _VBVAINFOSCREEN
|
---|
| 758 | {
|
---|
[17705] | 759 | /* Which view contains the screen. */
|
---|
| 760 | uint32_t u32ViewIndex;
|
---|
| 761 |
|
---|
[17624] | 762 | /* Physical X origin relative to the primary screen. */
|
---|
| 763 | int32_t i32OriginX;
|
---|
| 764 |
|
---|
| 765 | /* Physical Y origin relative to the primary screen. */
|
---|
| 766 | int32_t i32OriginY;
|
---|
| 767 |
|
---|
| 768 | /* The scan line size in bytes. */
|
---|
| 769 | uint32_t u32LineSize;
|
---|
| 770 |
|
---|
| 771 | /* Width of the screen. */
|
---|
| 772 | uint32_t u32Width;
|
---|
| 773 |
|
---|
| 774 | /* Height of the screen. */
|
---|
| 775 | uint32_t u32Height;
|
---|
| 776 |
|
---|
| 777 | /* Color depth. */
|
---|
| 778 | uint16_t u16BitsPerPixel;
|
---|
| 779 |
|
---|
| 780 | /* VBVA_SCREEN_F_* */
|
---|
| 781 | uint16_t u16Flags;
|
---|
| 782 | } VBVAINFOSCREEN;
|
---|
| 783 |
|
---|
| 784 |
|
---|
| 785 | /* VBVAENABLE::u32Flags */
|
---|
| 786 | #define VBVA_F_NONE 0x00000000
|
---|
| 787 | #define VBVA_F_ENABLE 0x00000001
|
---|
| 788 | #define VBVA_F_DISABLE 0x00000002
|
---|
| 789 |
|
---|
| 790 | typedef struct _VBVAENABLE
|
---|
| 791 | {
|
---|
| 792 | uint32_t u32Flags;
|
---|
[17676] | 793 | uint32_t u32Offset;
|
---|
[17624] | 794 |
|
---|
| 795 | } VBVAENABLE;
|
---|
| 796 |
|
---|
[19431] | 797 | typedef struct _VBVAMOUSEPOINTERSHAPE
|
---|
| 798 | {
|
---|
| 799 | /* The host result. */
|
---|
| 800 | uint32_t u32Result;
|
---|
[19464] | 801 |
|
---|
[19431] | 802 | /* VBOX_MOUSE_POINTER_* bit flags. */
|
---|
| 803 | uint32_t fu32Flags;
|
---|
| 804 |
|
---|
| 805 | /* X coordinate of the hot spot. */
|
---|
| 806 | uint32_t u32HotX;
|
---|
| 807 |
|
---|
| 808 | /* Y coordinate of the hot spot. */
|
---|
| 809 | uint32_t u32HotY;
|
---|
| 810 |
|
---|
| 811 | /* Width of the pointer in pixels. */
|
---|
| 812 | uint32_t u32Width;
|
---|
| 813 |
|
---|
| 814 | /* Height of the pointer in scanlines. */
|
---|
| 815 | uint32_t u32Height;
|
---|
| 816 |
|
---|
| 817 | /* Pointer data.
|
---|
| 818 | *
|
---|
| 819 | ****
|
---|
| 820 | * The data consists of 1 bpp AND mask followed by 32 bpp XOR (color) mask.
|
---|
| 821 | *
|
---|
| 822 | * For pointers without alpha channel the XOR mask pixels are 32 bit values: (lsb)BGR0(msb).
|
---|
| 823 | * For pointers with alpha channel the XOR mask consists of (lsb)BGRA(msb) 32 bit values.
|
---|
| 824 | *
|
---|
| 825 | * Guest driver must create the AND mask for pointers with alpha channel, so if host does not
|
---|
| 826 | * support alpha, the pointer could be displayed as a normal color pointer. The AND mask can
|
---|
| 827 | * be constructed from alpha values. For example alpha value >= 0xf0 means bit 0 in the AND mask.
|
---|
| 828 | *
|
---|
| 829 | * The AND mask is 1 bpp bitmap with byte aligned scanlines. Size of AND mask,
|
---|
| 830 | * therefore, is cbAnd = (width + 7) / 8 * height. The padding bits at the
|
---|
| 831 | * end of any scanline are undefined.
|
---|
| 832 | *
|
---|
| 833 | * The XOR mask follows the AND mask on the next 4 bytes aligned offset:
|
---|
| 834 | * uint8_t *pXor = pAnd + (cbAnd + 3) & ~3
|
---|
| 835 | * Bytes in the gap between the AND and the XOR mask are undefined.
|
---|
| 836 | * XOR mask scanlines have no gap between them and size of XOR mask is:
|
---|
| 837 | * cXor = width * 4 * height.
|
---|
| 838 | ****
|
---|
| 839 | *
|
---|
| 840 | * Preallocate 4 bytes for accessing actual data as p->au8Data.
|
---|
| 841 | */
|
---|
| 842 | uint8_t au8Data[4];
|
---|
| 843 |
|
---|
| 844 | } VBVAMOUSEPOINTERSHAPE;
|
---|
| 845 |
|
---|
[17624] | 846 | #pragma pack()
|
---|
| 847 |
|
---|
| 848 | #endif /* VBOX_WITH_HGSMI */
|
---|
| 849 |
|
---|
[3633] | 850 | #endif
|
---|