DrvMouseQueue.cpp revision ad48e47654d22f79b025dc4b21cb162cb123801a
/* $Id$ */
/** @file
* VBox input devices: Mouse queue driver
*/
/*
* Copyright (C) 2006-2010 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.
*/
/*******************************************************************************
* Header Files *
*******************************************************************************/
#define LOG_GROUP LOG_GROUP_DRV_MOUSE_QUEUE
#include "VBoxDD.h"
/*******************************************************************************
* Structures and Typedefs *
*******************************************************************************/
/**
* Mouse queue driver instance data.
*
* @implements PDMIMOUSECONNECTOR
* @implements PDMIMOUSEPORT
*/
typedef struct DRVMOUSEQUEUE
{
/** Pointer to the driver instance structure. */
/** Our mouse connector interface. */
/** Our mouse port interface. */
/** The queue handle. */
/** Discard input when this flag is set.
* We only accept input when the VM is running. */
bool fInactive;
/**
* Mouse queue item.
*/
typedef struct DRVMOUSEQUEUEITEM
{
/** The core part owned by the queue manager. */
/* -=-=-=-=- IBase -=-=-=-=- */
/**
* @interface_method_impl{PDMIBASE,pfnQueryInterface}
*/
{
return NULL;
}
/* -=-=-=-=- IMousePort -=-=-=-=- */
/** Converts a pointer to DRVMOUSEQUEUE::Port to a DRVMOUSEQUEUE pointer. */
#define IMOUSEPORT_2_DRVMOUSEQUEUE(pInterface) ( (PDRVMOUSEQUEUE)((char *)(pInterface) - RT_OFFSETOF(DRVMOUSEQUEUE, IPort)) )
/**
* @interface_method_impl{PDMIMOUSEPORT,pfnPutEvent}
*/
static DECLCALLBACK(int) drvMouseQueuePutEvent(PPDMIMOUSEPORT pInterface, int32_t iDeltaX, int32_t iDeltaY, int32_t iDeltaZ, int32_t iDeltaW, uint32_t fButtonStates)
{
return VINF_SUCCESS;
if (pItem)
{
return VINF_SUCCESS;
}
return VERR_PDM_NO_QUEUE_ITEMS;
}
/**
* @interface_method_impl{PDMIMOUSEPORT,pfnPutEventAbs}
*/
static DECLCALLBACK(int) drvMouseQueuePutEventAbs(PPDMIMOUSEPORT pInterface, uint32_t uX, uint32_t uY, int32_t iDeltaZ, int32_t iDeltaW, uint32_t fButtonStates)
{
return VINF_SUCCESS;
if (pItem)
{
return VINF_SUCCESS;
}
return VERR_PDM_NO_QUEUE_ITEMS;
}
/* -=-=-=-=- IConnector -=-=-=-=- */
#define PPDMIMOUSECONNECTOR_2_DRVMOUSEQUEUE(pInterface) ( (PDRVMOUSEQUEUE)((char *)(pInterface) - RT_OFFSETOF(DRVMOUSEQUEUE, IConnector)) )
/**
* Pass absolute mode status changes from the guest through to the frontend
* driver.
*
* @param pInterface Pointer to the mouse connector interface structure.
* @param fAbs The new absolute mode state.
*/
static DECLCALLBACK(void) drvMousePassThruReportModes(PPDMIMOUSECONNECTOR pInterface, bool fRel, bool fAbs)
{
}
/* -=-=-=-=- queue -=-=-=-=- */
/**
* Queue callback for processing a queued item.
*
* @returns Success indicator.
* If false the item will not be removed and the flushing will stop.
* @param pDrvIns The driver instance.
* @param pItemCore Pointer to the queue item to process.
*/
{
int rc;
rc = pThis->pUpPort->pfnPutEvent(pThis->pUpPort, pItem->iDeltaX, pItem->iDeltaY, pItem->iDeltaZ, pItem->iDeltaW, pItem->fButtonStates);
else
rc = pThis->pUpPort->pfnPutEventAbs(pThis->pUpPort, pItem->uX, pItem->uY, pItem->iDeltaZ, pItem->iDeltaW, pItem->fButtonStates);
return RT_SUCCESS(rc);
}
/* -=-=-=-=- driver interface -=-=-=-=- */
/**
* Power On notification.
*
* @returns VBox status.
* @param pDrvIns The drive instance data.
*/
{
}
/**
* Reset notification.
*
* @returns VBox status.
* @param pDrvIns The drive instance data.
*/
{
//PDRVKBDQUEUE pThis = PDMINS_2_DATA(pDrvIns, PDRVKBDQUEUE);
/** @todo purge the queue on reset. */
}
/**
* Suspend notification.
*
* @returns VBox status.
* @param pDrvIns The drive instance data.
*/
{
}
/**
* Resume notification.
*
* @returns VBox status.
* @param pDrvIns The drive instance data.
*/
{
}
/**
* Power Off notification.
*
* @param pDrvIns The drive instance data.
*/
{
}
/**
* Construct a mouse driver instance.
*
* @copydoc FNPDMDRVCONSTRUCT
*/
static DECLCALLBACK(int) drvMouseQueueConstruct(PPDMDRVINS pDrvIns, PCFGMNODE pCfg, uint32_t fFlags)
{
/*
* Validate configuration.
*/
/*
* Init basic data members and interfaces.
*/
/* IBase. */
/* IMouseConnector. */
/* IMousePort. */
/*
*/
{
AssertMsgFailed(("Configuration error: No mouse port interface above!\n"));
return VERR_PDM_MISSING_INTERFACE_ABOVE;
}
/*
* Attach driver below and query it's connector interface.
*/
if (RT_FAILURE(rc))
{
return rc;
}
if (!pDrv->pDownConnector)
{
AssertMsgFailed(("Configuration error: No mouse connector interface below!\n"));
return VERR_PDM_MISSING_INTERFACE_BELOW;
}
/*
* Create the queue.
*/
uint32_t cMilliesInterval = 0;
if (rc == VERR_CFGM_VALUE_NOT_FOUND)
cMilliesInterval = 0;
else if (RT_FAILURE(rc))
{
return rc;
}
if (rc == VERR_CFGM_VALUE_NOT_FOUND)
cItems = 128;
else if (RT_FAILURE(rc))
{
return rc;
}
rc = PDMDrvHlpQueueCreate(pDrvIns, sizeof(DRVMOUSEQUEUEITEM), cItems, cMilliesInterval, drvMouseQueueConsumer, "Mouse", &pDrv->pQueue);
if (RT_FAILURE(rc))
{
AssertMsgFailed(("Failed to create driver: cItems=%d cMilliesInterval=%d rc=%Rrc\n", cItems, cMilliesInterval, rc));
return rc;
}
return VINF_SUCCESS;
}
/**
* Mouse queue driver registration record.
*/
const PDMDRVREG g_DrvMouseQueue =
{
/* u32Version */
/* szName */
"MouseQueue",
/* szRCMod */
"",
/* szR0Mod */
"",
/* pszDescription */
"Mouse queue driver to plug in between the key source and the device to do queueing and inter-thread transport.",
/* fFlags */
/* fClass. */
/* cMaxInstances */
~0U,
/* cbInstance */
sizeof(DRVMOUSEQUEUE),
/* pfnConstruct */
/* pfnRelocate */
NULL,
/* pfnDestruct */
NULL,
/* pfnIOCtl */
NULL,
/* pfnPowerOn */
/* pfnReset */
/* pfnSuspend */
/* pfnResume */
/* pfnAttach */
NULL,
/* pfnDetach */
NULL,
/* pfnPowerOff */
/* pfnSoftReset */
NULL,
/* u32EndVersion */
};