VBoxGuestR3LibSeamless.cpp revision 553919970ed21dac836cee8af92d1382be79ac34
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync/** $Id$ */
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync/** @file
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * VBoxGuestR3Lib - Ring-3 Support Library for VirtualBox guest additions, Seamless mode.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync */
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync/*
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * Copyright (C) 2007 innotek GmbH
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync *
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * This file is part of VirtualBox Open Source Edition (OSE), as
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * available from http://www.virtualbox.org. This file is free software;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * you can redistribute it and/or modify it under the terms of the GNU
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * General Public License (GPL) as published by the Free Software
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * Foundation, in version 2 as it comes in the "COPYING" file of the
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync */
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync/*******************************************************************************
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync* Header Files *
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync*******************************************************************************/
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync#include <iprt/assert.h>
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync#include <iprt/string.h>
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync#include <VBox/VBoxGuest.h>
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync#include <VBox/VBoxDev.h>
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync#include <VBox/log.h>
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync#include "VBGLR3Internal.h"
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync/**
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * Tell the host that we support (or no longer support) seamless mode.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync *
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * @returns IPRT status value
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * @param fState whether or not we support seamless mode
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync *
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * @todo Currently this will trample over any other capabilities the guest may have.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * This will have to be fixed when more capabilities are added at the latest.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync */
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncVBGLR3DECL(int) VbglR3SeamlessSetCap(bool fState)
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync{
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync VMMDevReqGuestCapabilities vmmreqGuestCaps;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync int rc = VINF_SUCCESS;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync memset(&vmmreqGuestCaps, 0, sizeof(vmmreqGuestCaps));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync vmmdevInitRequest(&vmmreqGuestCaps.header, VMMDevReq_ReportGuestCapabilities);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync vmmreqGuestCaps.caps = fState ? VMMDEV_GUEST_SUPPORTS_SEAMLESS : 0;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync rc = vbglR3GRPerform(&vmmreqGuestCaps.header);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync#ifdef DEBUG
if (RT_SUCCESS(rc))
LogRel(("Successfully set the seamless capability on the host.\n"));
else
LogRel(("Failed to set the seamless capability on the host, rc = %Rrc.\n", rc));
#endif
return rc;
}
/**
* Wait for a seamless mode change event.
*
* @returns IPRT status value
* @retval pMode on success, the seamless mode to switch into (i.e. disabled, visible region
* or host window)
*/
VBGLR3DECL(int) VbglR3SeamlessWaitEvent(VMMDevSeamlessMode *pMode)
{
VBoxGuestWaitEventInfo waitEvent;
int rc;
AssertPtrReturn(pMode, VERR_INVALID_PARAMETER);
waitEvent.u32TimeoutIn = RT_INDEFINITE_WAIT;
waitEvent.u32EventMaskIn = VMMDEV_EVENT_SEAMLESS_MODE_CHANGE_REQUEST;
rc = vbglR3DoIOCtl(VBOXGUEST_IOCTL_WAITEVENT, &waitEvent, sizeof(waitEvent));
if (RT_SUCCESS(rc))
{
/* did we get the right event? */
if (waitEvent.u32EventFlagsOut & VMMDEV_EVENT_SEAMLESS_MODE_CHANGE_REQUEST)
{
VMMDevSeamlessChangeRequest seamlessChangeRequest;
/* get the seamless change request */
vmmdevInitRequest(&seamlessChangeRequest.header, VMMDevReq_GetSeamlessChangeRequest);
seamlessChangeRequest.eventAck = VMMDEV_EVENT_SEAMLESS_MODE_CHANGE_REQUEST;
rc = vbglR3GRPerform(&seamlessChangeRequest.header);
if (RT_SUCCESS(rc))
{
*pMode = seamlessChangeRequest.mode;
return VINF_SUCCESS;
}
}
else
rc = VERR_TRY_AGAIN;
}
return rc;
}
/**
* Inform the host about the visible region
*
* @returns IPRT status code
* @param cRects number of rectangles in the list of visible rectangles
* @param pRects list of visible rectangles on the guest display
*
* @todo A scatter-gather version of vbglR3GRPerform would be nice, so that we don't have
* to copy our rectangle and header data into a single structure and perform an
* additional allocation.
*/
VBGLR3DECL(int) VbglR3SeamlessSendRects(uint32_t cRects, PRTRECT pRects)
{
VMMDevVideoSetVisibleRegion *pReq;
int rc;
if (0 == cRects)
return VINF_SUCCESS;
rc = vbglR3GRAlloc((VMMDevRequestHeader **)&pReq,
sizeof(VMMDevVideoSetVisibleRegion) + (cRects - 1) * sizeof(RTRECT),
VMMDevReq_VideoSetVisibleRegion);
if (RT_SUCCESS(rc))
{
pReq->cRect = cRects;
memcpy(&pReq->Rect, pRects, cRects * sizeof(RTRECT));
rc = vbglR3GRPerform(&pReq->header);
vbglR3GRFree(&pReq->header);
if (RT_SUCCESS(rc))
{
if (RT_SUCCESS(pReq->header.rc))
return VINF_SUCCESS;
rc = pReq->header.rc;
}
}
return rc;
}