VBoxGuestR3LibSeamless.cpp revision c7814cf6e1240a519cbec0441e033d0e2470ed00
/* $Id$ */
/** @file
* VBoxGuestR3Lib - Ring-3 Support Library for VirtualBox guest additions, Seamless mode.
*/
/*
* Copyright (C) 2007-2011 Oracle Corporation
*
* This file is part of VirtualBox Open Source Edition (OSE), as
* available from http://www.virtualbox.org. This file is free software;
* 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 "VBGLR3Internal.h"
#ifdef VBOX_VBGLR3_XFREE86
/* Rather than try to resolve all the header file conflicts, I will just
prototype what we need here. */
# define memcpy xf86memcpy
#endif /* VBOX_VBGLR3_XFREE86 */
/**
* Tell the host that we support (or no longer support) seamless mode.
*
* @returns IPRT status value
* @param fState whether or not we support seamless mode
*/
{
if (fState)
return VbglR3SetGuestCaps(VMMDEV_GUEST_SUPPORTS_SEAMLESS, 0);
return VbglR3SetGuestCaps(0, VMMDEV_GUEST_SUPPORTS_SEAMLESS);
}
/**
* Wait for a seamless mode change event.
*
* @returns IPRT status value.
* @param[out] pMode On success, the seamless mode to switch into (i.e.
* disabled, visible region or host window).
*/
{
int rc;
if (RT_SUCCESS(rc))
{
/* did we get the right event? */
{
/* get the seamless change request */
if (RT_SUCCESS(rc))
{
return VINF_SUCCESS;
}
}
else
rc = VERR_TRY_AGAIN;
}
return rc;
}
/**
* Request the last seamless mode switch from the host again.
*
* @returns IPRT status value.
* @param[out] pMode On success, the seamless mode that was switched
* into (i.e. disabled, visible region or host window).
*/
{
int rc;
/* get the seamless change request */
if (RT_SUCCESS(rc))
{
return VINF_SUCCESS;
}
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.
* @todo Would that really gain us much, given that the rectangles may not
* be grouped at all, or in the format we need? Keeping the memory
* for our "single structure" around (re-alloc-ing it if necessary)
* sounds like a simpler optimisation if we need it.
*/
{
int rc;
sizeof(VMMDevVideoSetVisibleRegion)
- sizeof(RTRECT),
if (RT_SUCCESS(rc))
{
if (cRects)
/* This will fail harmlessly for cRect == 0 and older host code */
LogFunc(("Visible region request returned %Rrc, internal %Rrc.\n",
if (RT_SUCCESS(rc))
}
return rc;
}