DECLVBGL(int) VbglHGCMConnect (VBGLHGCMHANDLE *pHandle, VBoxGuestHGCMConnectInfo *pData) { int rc; struct VBGLHGCMHANDLEDATA *pHandleData; if (!pHandle || !pData) return VERR_INVALID_PARAMETER; pHandleData = vbglHGCMHandleAlloc(); if (!pHandleData) rc = VERR_NO_MEMORY; else { rc = vbglDriverOpen (&pHandleData->driver); if (RT_SUCCESS(rc)) { rc = vbglDriverIOCtl (&pHandleData->driver, VBOXGUEST_IOCTL_HGCM_CONNECT, pData, sizeof (*pData)); if (RT_SUCCESS(rc)) rc = pData->result; if (RT_SUCCESS(rc)) { *pHandle = pHandleData; return rc; } vbglDriverClose (&pHandleData->driver); } vbglHGCMHandleFree (pHandleData); } return rc; }
/** * Retrieve mouse coordinates and features from the host. * * @remarks Ring-0. * @returns VBox status code. * * @param pfFeatures Where to store the mouse features. * @param px Where to store the X co-ordinate. * @param py Where to store the Y co-ordinate. */ DECLVBGL(int) VbglGetMouseStatus(uint32_t *pfFeatures, uint32_t *px, uint32_t *py) { VMMDevReqMouseStatus Req; VBGLDRIVER *pDriver; int rc; rc = vbglGetDriver(&pDriver); if (RT_FAILURE(rc)) return rc; vmmdevInitRequest(&Req.header, VMMDevReq_GetMouseStatus); Req.mouseFeatures = 0; Req.pointerXPos = 0; Req.pointerYPos = 0; rc = vbglDriverIOCtl(pDriver, VBOXGUEST_IOCTL_VMMREQUEST(sizeof(Req)), &Req.header, sizeof(Req)); if (RT_FAILURE(rc)) return rc; if (RT_FAILURE(Req.header.rc)) return Req.header.rc; if (pfFeatures) *pfFeatures = Req.mouseFeatures; if (px) *px = Req.pointerXPos; if (py) *py = Req.pointerYPos; return VINF_SUCCESS; }
DECLVBGL(int) VbglR0CrCtlConConnect(VBGLCRCTLHANDLE hCtl, HGCMCLIENTID *pidClient) { VBoxGuestHGCMConnectInfo info; int rc; if (!hCtl || !pidClient) return VERR_INVALID_PARAMETER; RT_ZERO(info); info.Loc.type = VMMDevHGCMLoc_LocalHost_Existing; RTStrCopy(info.Loc.u.host.achName, sizeof(info.Loc.u.host.achName), "VBoxSharedCrOpenGL"); rc = vbglDriverIOCtl(&hCtl->driver, VBOXGUEST_IOCTL_HGCM_CONNECT, &info, sizeof(info)); if (RT_SUCCESS(rc)) { rc = info.result; if (RT_SUCCESS(rc)) { Assert(info.u32ClientID); *pidClient = info.u32ClientID; return rc; } } AssertRC(rc); *pidClient = 0; return rc; }
DECLVBGL(int) VbglR0CrCtlConDisconnect(VBGLCRCTLHANDLE hCtl, HGCMCLIENTID idClient) { VBoxGuestHGCMDisconnectInfo info; RT_ZERO(info); info.u32ClientID = idClient; return vbglDriverIOCtl(&hCtl->driver, VBOXGUEST_IOCTL_HGCM_DISCONNECT, &info, sizeof(info)); }
DECLVBGL(int) vboxCrCtlConConnect(HVBOXCRCTL hCtl, uint32_t *pu32ClientID) { VBoxGuestHGCMConnectInfo info; int rc; if (!hCtl || !pu32ClientID) return VERR_INVALID_PARAMETER; memset(&info, 0, sizeof (info)); info.Loc.type = VMMDevHGCMLoc_LocalHost_Existing; RTStrCopy(info.Loc.u.host.achName, sizeof (info.Loc.u.host.achName), "VBoxSharedCrOpenGL"); rc = vbglDriverIOCtl (&hCtl->driver, VBOXGUEST_IOCTL_HGCM_CONNECT, &info, sizeof (info)); if (RT_SUCCESS(rc)) { rc = info.result; if (RT_SUCCESS(rc)) { Assert(info.u32ClientID); *pu32ClientID = info.u32ClientID; return rc; } } Assert(RT_FAILURE(rc)); *pu32ClientID = 0; return rc; }
DECLVBGL(int) vboxCrCtlConDisconnect(HVBOXCRCTL hCtl, uint32_t u32ClientID) { VBoxGuestHGCMDisconnectInfo info; memset (&info, 0, sizeof (info)); info.u32ClientID = u32ClientID; return vbglDriverIOCtl (&hCtl->driver, VBOXGUEST_IOCTL_HGCM_DISCONNECT, &info, sizeof (info)); }
/** * Send mouse features to the host. * * @remarks Ring-0. * @returns VBox status code. * * @param fFeatures Supported mouse pointer features. The main guest driver * will mediate different callers and show the host any * feature enabled by any guest caller. */ DECLVBGL(int) VbglSetMouseStatus(uint32_t fFeatures) { VBGLDRIVER *pDriver; int rc; rc = vbglGetDriver(&pDriver); if (RT_FAILURE(rc)) return rc; return vbglDriverIOCtl(pDriver, VBOXGUEST_IOCTL_SET_MOUSE_STATUS, &fFeatures, sizeof(fFeatures)); }
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))); rc = vbglDriverIOCtl (&handle->driver, VBOXGUEST_IOCTL_HGCM_CALL_USERDATA(cbData), pData, cbData); return rc; }
/** * Sets the function which is called back on each mouse pointer event. Only * one callback can be active at once, so if you need several for any reason * you must multiplex yourself. Call backs can be disabled by passing NULL * as the function pointer. * * @remarks Ring-0. * @returns iprt status code. * @returns VERR_TRY_AGAIN if the main guest driver hasn't finished * initialising. * * @param pfnNotify the function to call back. NULL to disable call backs. * @param pvUser user supplied data/cookie to be passed to the function. */ DECLVBGL(int) VbglSetMouseNotifyCallback(PFNVBOXGUESTMOUSENOTIFY pfnNotify, void *pvUser) { VBoxGuestMouseSetNotifyCallback NotifyCallback; VBGLDRIVER *pDriver; int rc = vbglGetDriver(&pDriver); if (RT_FAILURE(rc)) return rc; NotifyCallback.pfnNotify = pfnNotify; NotifyCallback.pvUser = pvUser; return vbglDriverIOCtl(pDriver, VBOXGUEST_IOCTL_SET_MOUSE_NOTIFY_CALLBACK, &NotifyCallback, sizeof(NotifyCallback)); }
DECLVBGL(int) VbglHGCMDisconnect (VBGLHGCMHANDLE handle, VBoxGuestHGCMDisconnectInfo *pData) { int rc = VINF_SUCCESS; rc = vbglDriverIOCtl (&handle->driver, VBOXGUEST_IOCTL_HGCM_DISCONNECT, pData, sizeof (*pData)); vbglDriverClose (&handle->driver); vbglHGCMHandleFree (handle); return rc; }
DECLVBGL(int) VbglHGCMCallTimed (VBGLHGCMHANDLE handle, VBoxGuestHGCMCallInfoTimed *pData, uint32_t cbData) { int rc = VINF_SUCCESS; uint32_t cbExpected = sizeof (VBoxGuestHGCMCallInfoTimed) + pData->info.cParms * sizeof (HGCMFunctionParameter); VBGL_HGCM_ASSERTMsg(cbData >= cbExpected, ("cbData = %d, cParms = %d (calculated size %d)\n", cbData, pData->info.cParms, cbExpected)); rc = vbglDriverIOCtl (&handle->driver, VBOXGUEST_IOCTL_HGCM_CALL_TIMED(cbData), pData, cbData); return rc; }
/** * The guest library uses lazy initialization for VMMDev port and memory, * because these values are provided by the VBoxGuest driver and it might * be loaded later than other drivers. * * The VbglEnter checks the current library status, tries to retrieve these * values and fails if they are unavailable. * */ static void vbglQueryDriverInfo (void) { int rc = VINF_SUCCESS; rc = RTSemMutexRequest(g_vbgldata.mutexDriverInit, RT_INDEFINITE_WAIT); if (RT_FAILURE(rc)) return; if (g_vbgldata.status == VbglStatusReady) { RTSemMutexRelease(g_vbgldata.mutexDriverInit); return; } rc = vbglDriverOpen(&g_vbgldata.driver); if (RT_SUCCESS(rc)) { /* * Try query the port info. */ VBoxGuestPortInfo port; rc = vbglDriverIOCtl (&g_vbgldata.driver, VBOXGUEST_IOCTL_GETVMMDEVPORT, &port, sizeof (port)); if (RT_SUCCESS (rc)) { dprintf (("port = 0x%04X, mem = %p\n", port.portAddress, port.pVMMDevMemory)); g_vbgldata.portVMMDev = (RTIOPORT)port.portAddress; g_vbgldata.pVMMDevMemory = port.pVMMDevMemory; g_vbgldata.status = VbglStatusReady; vbglR0QueryHostVersion(); } } RTSemMutexRelease(g_vbgldata.mutexDriverInit); dprintf (("vbglQueryDriverInfo rc = %d\n", rc)); }
DECLVBGL(int) VbglR0CrCtlConCallUserData(VBGLCRCTLHANDLE hCtl, struct VBoxGuestHGCMCallInfo *pCallInfo, int cbCallInfo) { return vbglDriverIOCtl(&hCtl->driver, VBOXGUEST_IOCTL_HGCM_CALL_USERDATA(cbCallInfo), pCallInfo, cbCallInfo); }
DECLVBGL(int) vboxCrCtlConCall(HVBOXCRCTL hCtl, struct VBoxGuestHGCMCallInfo *pCallInfo, int cbCallInfo) { return vbglDriverIOCtl (&hCtl->driver, VBOXGUEST_IOCTL_HGCM_CALL(cbCallInfo), pCallInfo, cbCallInfo); }