/* $Id: VBoxGuestR3LibVideo.cpp 33540 2010-10-28 09:27:05Z vboxsync $ */ /** @file * VBoxGuestR3Lib - Ring-3 Support Library for VirtualBox guest additions, Video. */ /* * Copyright (C) 2007-2009 Oracle Corporation * * This file is part of VirtualBox Open Source Edition (OSE), as * available from http://www.virtualbox.org. This file is free software; * you can redistribute it and/or modify it under the terms of the GNU * General Public License (GPL) as published by the Free Software * Foundation, in version 2 as it comes in the "COPYING" file of the * VirtualBox OSE distribution. VirtualBox OSE is distributed in the * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind. * * The contents of this file may alternatively be used under the terms * of the Common Development and Distribution License Version 1.0 * (CDDL) only, as it comes in the "COPYING.CDDL" file of the * VirtualBox OSE distribution, in which case the provisions of the * CDDL are applicable instead of those of the GPL. * * You may elect to license modified versions of this file under the * terms and conditions of either the GPL or the CDDL or both. */ /******************************************************************************* * Header Files * *******************************************************************************/ #include #ifndef VBOX_VBGLR3_XFREE86 # include #endif #include #include #include /* For Save and RetrieveVideoMode */ #include "VBGLR3Internal.h" #ifdef VBOX_VBGLR3_XFREE86 /* Rather than try to resolve all the header file conflicts, I will just prototype what we need here. */ extern "C" void* xf86memcpy(void*,const void*,xf86size_t); # undef memcpy # define memcpy xf86memcpy extern "C" void* xf86memset(const void*,int,xf86size_t); # undef memset # define memset xf86memset #endif /* VBOX_VBGLR3_XFREE86 */ #define VIDEO_PROP_PREFIX "/VirtualBox/GuestAdd/Vbgl/Video/" /** * Enable or disable video acceleration. * * @returns VBox status code. * * @param fEnable Pass zero to disable, any other value to enable. */ VBGLR3DECL(int) VbglR3VideoAccelEnable(bool fEnable) { VMMDevVideoAccelEnable Req; vmmdevInitRequest(&Req.header, VMMDevReq_VideoAccelEnable); Req.u32Enable = fEnable; Req.cbRingBuffer = VBVA_RING_BUFFER_SIZE; Req.fu32Status = 0; return vbglR3GRPerform(&Req.header); } /** * Flush the video buffer. * * @returns VBox status code. */ VBGLR3DECL(int) VbglR3VideoAccelFlush(void) { VMMDevVideoAccelFlush Req; vmmdevInitRequest(&Req.header, VMMDevReq_VideoAccelFlush); return vbglR3GRPerform(&Req.header); } /** * Send mouse pointer shape information to the host. * * @returns VBox status code. * * @param fFlags Mouse pointer flags. * @param xHot X coordinate of hot spot. * @param yHot Y coordinate of hot spot. * @param cx Pointer width. * @param cy Pointer height. * @param pvImg Pointer to the image data (can be NULL). * @param cbImg Size of the image data pointed to by pvImg. */ VBGLR3DECL(int) VbglR3SetPointerShape(uint32_t fFlags, uint32_t xHot, uint32_t yHot, uint32_t cx, uint32_t cy, const void *pvImg, size_t cbImg) { VMMDevReqMousePointer *pReq; size_t cbReq = vmmdevGetMousePointerReqSize(cx, cy); AssertReturn( !pvImg || cbReq == RT_OFFSETOF(VMMDevReqMousePointer, pointerData) + cbImg, VERR_INVALID_PARAMETER); int rc = vbglR3GRAlloc((VMMDevRequestHeader **)&pReq, cbReq, VMMDevReq_SetPointerShape); if (RT_SUCCESS(rc)) { pReq->fFlags = fFlags; pReq->xHot = xHot; pReq->yHot = yHot; pReq->width = cx; pReq->height = cy; if (pvImg) memcpy(pReq->pointerData, pvImg, cbImg); rc = vbglR3GRPerform(&pReq->header); if (RT_SUCCESS(rc)) rc = pReq->header.rc; vbglR3GRFree(&pReq->header); } return rc; } /** * Send mouse pointer shape information to the host. * This version of the function accepts a request for clients that * already allocate and manipulate the request structure directly. * * @returns VBox status code. * * @param pReq Pointer to the VMMDevReqMousePointer structure. */ VBGLR3DECL(int) VbglR3SetPointerShapeReq(VMMDevReqMousePointer *pReq) { int rc = vbglR3GRPerform(&pReq->header); if (RT_SUCCESS(rc)) rc = pReq->header.rc; return rc; } /** * Query the last display change request sent from the host to the guest. * * @returns iprt status value * @param pcx Where to store the horizontal pixel resolution * requested (a value of zero means do not change). * @param pcy Where to store the vertical pixel resolution * requested (a value of zero means do not change). * @param pcBits Where to store the bits per pixel requested (a value * of zero means do not change). * @param iDisplay Where to store the display number the request was for * - 0 for the primary display, 1 for the first * secondary display, etc. * @param fAck whether or not to acknowledge the newest request sent by * the host. If this is set, the function will return the * most recent host request, otherwise it will return the * last request to be acknowledged. * */ VBGLR3DECL(int) VbglR3GetDisplayChangeRequest(uint32_t *pcx, uint32_t *pcy, uint32_t *pcBits, uint32_t *piDisplay, bool fAck) { VMMDevDisplayChangeRequest2 Req; AssertPtrReturn(pcx, VERR_INVALID_PARAMETER); AssertPtrReturn(pcy, VERR_INVALID_PARAMETER); AssertPtrReturn(pcBits, VERR_INVALID_PARAMETER); AssertPtrReturn(piDisplay, VERR_INVALID_PARAMETER); RT_ZERO(Req); vmmdevInitRequest(&Req.header, VMMDevReq_GetDisplayChangeRequest2); if (fAck) Req.eventAck = VMMDEV_EVENT_DISPLAY_CHANGE_REQUEST; int rc = vbglR3GRPerform(&Req.header); if (RT_SUCCESS(rc)) rc = Req.header.rc; if (RT_SUCCESS(rc)) { *pcx = Req.xres; *pcy = Req.yres; *pcBits = Req.bpp; *piDisplay = Req.display; } return rc; } /** * Query the host as to whether it likes a specific video mode. * * @returns the result of the query * @param cx the width of the mode being queried * @param cy the height of the mode being queried * @param cBits the bpp of the mode being queried */ VBGLR3DECL(bool) VbglR3HostLikesVideoMode(uint32_t cx, uint32_t cy, uint32_t cBits) { bool fRc = true; /* If for some reason we can't contact the host then * we like everything. */ int rc; VMMDevVideoModeSupportedRequest req; vmmdevInitRequest(&req.header, VMMDevReq_VideoModeSupported); req.width = cx; req.height = cy; req.bpp = cBits; req.fSupported = true; rc = vbglR3GRPerform(&req.header); if (RT_SUCCESS(rc) && RT_SUCCESS(req.header.rc)) fRc = req.fSupported; return fRc; } /** * Save video mode parameters to the registry. * * @returns iprt status value * @param pszName the name to save the mode parameters under * @param cx mode width * @param cy mode height * @param cBits bits per pixel for the mode */ VBGLR3DECL(int) VbglR3SaveVideoMode(const char *pszName, uint32_t cx, uint32_t cy, uint32_t cBits) { #if defined(VBOX_WITH_GUEST_PROPS) using namespace guestProp; char szModeName[MAX_NAME_LEN]; char szModeParms[MAX_VALUE_LEN]; uint32_t u32ClientId = 0; RTStrPrintf(szModeName, sizeof(szModeName), VIDEO_PROP_PREFIX"%s", pszName); RTStrPrintf(szModeParms, sizeof(szModeParms), "%dx%dx%d", cx, cy, cBits); int rc = VbglR3GuestPropConnect(&u32ClientId); if (RT_SUCCESS(rc)) rc = VbglR3GuestPropWriteValue(u32ClientId, szModeName, szModeParms); if (u32ClientId != 0) VbglR3GuestPropDisconnect(u32ClientId); /* Return value ignored, because what can we do anyway? */ return rc; #else /* !VBOX_WITH_GUEST_PROPS */ return VERR_NOT_IMPLEMENTED; #endif /* !VBOX_WITH_GUEST_PROPS */ } /** * Retrieve video mode parameters from the guest property store. * * @returns iprt status value * @param pszName the name under which the mode parameters are saved * @param pcx where to store the mode width * @param pcy where to store the mode height * @param pcBits where to store the bits per pixel for the mode */ VBGLR3DECL(int) VbglR3RetrieveVideoMode(const char *pszName, uint32_t *pcx, uint32_t *pcy, uint32_t *pcBits) { #if defined(VBOX_WITH_GUEST_PROPS) using namespace guestProp; /* * First we retrieve the video mode which is saved as a string in the * guest property store. */ /* The buffer for VbglR3GuestPropReadValue. If this is too small then * something is wrong with the data stored in the property. */ char szModeParms[1024]; uint32_t u32ClientId = 0; uint32_t cx, cy, cBits; int rc = VbglR3GuestPropConnect(&u32ClientId); if (RT_SUCCESS(rc)) { char szModeName[MAX_NAME_LEN]; RTStrPrintf(szModeName, sizeof(szModeName), VIDEO_PROP_PREFIX"%s", pszName); /** @todo add a VbglR3GuestPropReadValueF/FV that does the RTStrPrintf for you. */ rc = VbglR3GuestPropReadValue(u32ClientId, szModeName, szModeParms, sizeof(szModeParms), NULL); } /* * Now we convert the string returned to numeric values. */ char *pszNext; if (RT_SUCCESS(rc)) /* Extract the width from the string */ rc = RTStrToUInt32Ex(szModeParms, &pszNext, 10, &cx); if ((rc != VWRN_TRAILING_CHARS) || (*pszNext != 'x')) rc = VERR_PARSE_ERROR; if (RT_SUCCESS(rc)) { /* Extract the height from the string */ ++pszNext; rc = RTStrToUInt32Ex(pszNext, &pszNext, 10, &cy); } if ((rc != VWRN_TRAILING_CHARS) || (*pszNext != 'x')) rc = VERR_PARSE_ERROR; if (RT_SUCCESS(rc)) { /* Extract the bpp from the string */ ++pszNext; rc = RTStrToUInt32Full(pszNext, 10, &cBits); } if (rc != VINF_SUCCESS) rc = VERR_PARSE_ERROR; /* * And clean up and return the values if we successfully obtained them. */ if (u32ClientId != 0) VbglR3GuestPropDisconnect(u32ClientId); /* Return value ignored, because what can we do anyway? */ if (RT_SUCCESS(rc)) { *pcx = cx; *pcy = cy; *pcBits = cBits; } return rc; #else /* !VBOX_WITH_GUEST_PROPS */ return VERR_NOT_IMPLEMENTED; #endif /* !VBOX_WITH_GUEST_PROPS */ }