VirtualBox

source: vbox/trunk/src/VBox/Main/include/HGCM.h@ 75488

Last change on this file since 75488 was 75167, checked in by vboxsync, 6 years ago

Main/HGCM: Must deregister the 'guestprops' info item before shutting down HGCM, otherwise we risk calling into freed DLL memory should a guru happen later in the VM destruction/whatever process.

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 2.2 KB
Line 
1/* $Id: HGCM.h 75167 2018-10-29 21:03:40Z vboxsync $ */
2/** @file
3 * HGCM - Host-Guest Communication Manager.
4 */
5
6/*
7 * Copyright (C) 2006-2017 Oracle Corporation
8 *
9 * This file is part of VirtualBox Open Source Edition (OSE), as
10 * available from http://www.virtualbox.org. This file is free software;
11 * you can redistribute it and/or modify it under the terms of the GNU
12 * General Public License (GPL) as published by the Free Software
13 * Foundation, in version 2 as it comes in the "COPYING" file of the
14 * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
15 * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
16 */
17
18#ifndef __HGCM_h__
19#define __HGCM_h__
20
21#include <VBox/cdefs.h>
22#include <VBox/types.h>
23#include <VBox/vmm/pdmifs.h>
24
25#include <VBox/VMMDev.h>
26#include <VBox/hgcmsvc.h>
27
28/* HGCM saved state version */
29#define HGCM_SSM_VERSION 2
30
31/* Handle of a HGCM service extension. */
32struct _HGCMSVCEXTHANDLEDATA;
33typedef struct _HGCMSVCEXTHANDLEDATA *HGCMSVCEXTHANDLE;
34
35RT_C_DECLS_BEGIN
36int HGCMHostInit (void);
37int HGCMHostShutdown (void);
38
39int HGCMHostReset (void);
40
41int HGCMHostLoad (const char *pszServiceLibrary, const char *pszServiceName);
42
43int HGCMHostRegisterServiceExtension (HGCMSVCEXTHANDLE *pHandle, const char *pszServiceName, PFNHGCMSVCEXT pfnExtension, void *pvExtension);
44void HGCMHostUnregisterServiceExtension (HGCMSVCEXTHANDLE handle);
45
46int HGCMGuestConnect (PPDMIHGCMPORT pHGCMPort, PVBOXHGCMCMD pCmdPtr, const char *pszServiceName, uint32_t *pClientID);
47int HGCMGuestDisconnect (PPDMIHGCMPORT pHGCMPort, PVBOXHGCMCMD pCmdPtr, uint32_t clientID);
48int HGCMGuestCall (PPDMIHGCMPORT pHGCMPort, PVBOXHGCMCMD pCmdPtr, uint32_t clientID, uint32_t function, uint32_t cParms, VBOXHGCMSVCPARM *paParms);
49
50int HGCMHostCall (const char *pszServiceName, uint32_t function, uint32_t cParms, VBOXHGCMSVCPARM aParms[]);
51
52#ifdef VBOX_WITH_CRHGSMI
53int HGCMHostSvcHandleCreate (const char *pszServiceName, HGCMCVSHANDLE * phSvc);
54int HGCMHostSvcHandleDestroy (HGCMCVSHANDLE hSvc);
55int HGCMHostFastCallAsync (HGCMCVSHANDLE hSvc, uint32_t function, PVBOXHGCMSVCPARM pParm, PHGCMHOSTFASTCALLCB pfnCompletion, void *pvCompletion);
56#endif
57
58int HGCMHostSaveState (PSSMHANDLE pSSM);
59int HGCMHostLoadState (PSSMHANDLE pSSM);
60
61RT_C_DECLS_END
62
63#endif /* !__HGCM_h__ */
Note: See TracBrowser for help on using the repository browser.

© 2024 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette