HGCM.cpp revision 87150caf549846b0edba30c50dabe5092df70b5f
/* $Revision$ */
/** @file
* VBoxGuestLib - Host-Guest Communication Manager.
*
* These public functions can be only used by other drivers. They all
* do an IOCTL to VBoxGuest via IDC.
*/
/*
* Copyright (C) 2006-2007 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.
*/
/* Entire file is ifdef'ed with !VBGL_VBOXGUEST */
#ifndef VBGL_VBOXGUEST
#include "VBGLInternal.h"
#include <iprt/semaphore.h>
#define VBGL_HGCM_ASSERTMsg AssertReleaseMsg
/**
* Initializes the HGCM VBGL bits.
*
* @return VBox status code.
*/
int vbglR0HGCMInit (void)
{
}
/**
* Initializes the HGCM VBGL bits.
*
* @return VBox status code.
*/
int vbglR0HGCMTerminate (void)
{
return VINF_SUCCESS;
}
DECLINLINE(int) vbglHandleHeapEnter (void)
{
("Failed to request handle heap mutex, rc = %Rrc\n", rc));
return rc;
}
DECLINLINE(void) vbglHandleHeapLeave (void)
{
}
struct VBGLHGCMHANDLEDATA *vbglHGCMHandleAlloc (void)
{
struct VBGLHGCMHANDLEDATA *p;
int rc = vbglHandleHeapEnter ();
uint32_t i;
if (RT_FAILURE (rc))
return NULL;
p = NULL;
/** Simple linear search in array. This will be called not so often, only connect/disconnect.
* @todo bitmap for faster search and other obvious optimizations.
*/
{
{
p = &g_vbgldata.aHGCMHandleData[i];
p->fAllocated = 1;
break;
}
}
VBGL_HGCM_ASSERTMsg(p != NULL,
("Not enough HGCM handles.\n"));
return p;
}
{
int rc;
if (!pHandle)
return;
rc = vbglHandleHeapEnter ();
if (RT_FAILURE (rc))
return;
("Freeing not allocated handle.\n"));
return;
}
{
int rc;
struct VBGLHGCMHANDLEDATA *pHandleData;
return VERR_INVALID_PARAMETER;
rc = VINF_SUCCESS;
if (!pHandleData)
{
rc = VERR_NO_MEMORY;
}
else
{
if (RT_SUCCESS(rc))
{
if (RT_SUCCESS(rc))
{
*pHandle = pHandleData;
}
else
{
}
}
if (RT_FAILURE(rc))
{
}
}
return rc;
}
{
int rc = VINF_SUCCESS;
return rc;
}
{
int rc = VINF_SUCCESS;
VBGL_HGCM_ASSERTMsg(cbData >= sizeof (VBoxGuestHGCMCallInfo) + pData->cParms * sizeof (HGCMFunctionParameter),
("cbData = %d, cParms = %d (calculated size %d)\n", cbData, pData->cParms, sizeof (VBoxGuestHGCMCallInfo) + pData->cParms * sizeof (VBoxGuestHGCMCallInfo)));
return rc;
}
DECLVBGL(int) VbglHGCMCallUserData (VBGLHGCMHANDLE handle, VBoxGuestHGCMCallInfo *pData, uint32_t cbData)
{
int rc = VINF_SUCCESS;
VBGL_HGCM_ASSERTMsg(cbData >= sizeof (VBoxGuestHGCMCallInfo) + pData->cParms * sizeof (HGCMFunctionParameter),
("cbData = %d, cParms = %d (calculated size %d)\n", cbData, pData->cParms, sizeof (VBoxGuestHGCMCallInfo) + pData->cParms * sizeof (VBoxGuestHGCMCallInfo)));
return rc;
}
{
int rc = VINF_SUCCESS;
("cbData = %d, cParms = %d (calculated size %d)\n",
return rc;
}
#endif /* !VBGL_VBOXGUEST */