VirtualBox

source: vbox/trunk/src/VBox/HostServices/SharedClipboard/VBoxClipboard.h@ 78316

Last change on this file since 78316 was 78151, checked in by vboxsync, 6 years ago

Shared Clipboard: Got rid of a lot of duplicated code between Windows hosts / guests, plus a lot of renaming / cleanup, some more documentation.

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 2.7 KB
Line 
1/* $Id: VBoxClipboard.h 78151 2019-04-17 12:03:42Z vboxsync $ */
2/** @file
3 * Shared Clipboard Service - Internal Header.
4 */
5
6/*
7 * Copyright (C) 2006-2019 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 VBOX_INCLUDED_SRC_SharedClipboard_VBoxClipboard_h
19#define VBOX_INCLUDED_SRC_SharedClipboard_VBoxClipboard_h
20#ifndef RT_WITHOUT_PRAGMA_ONCE
21# pragma once
22#endif
23
24#include <VBox/hgcmsvc.h>
25#include <VBox/log.h>
26
27#include <VBox/GuestHost/SharedClipboard.h>
28
29typedef struct _VBOXCLIPBOARDCLIENTDATA
30{
31 struct _VBOXCLIPBOARDCLIENTDATA *pNext;
32 struct _VBOXCLIPBOARDCLIENTDATA *pPrev;
33
34 VBOXCLIPBOARDCONTEXT *pCtx;
35
36 uint32_t u32ClientID;
37
38 bool fAsync; /* Guest is waiting for a message. */
39 bool fReadPending; /* The guest is waiting for data from the host */
40
41 bool fMsgQuit;
42 bool fMsgReadData;
43 bool fMsgFormats;
44
45 struct {
46 VBOXHGCMCALLHANDLE callHandle;
47 VBOXHGCMSVCPARM *paParms;
48 } async;
49
50 struct {
51 VBOXHGCMCALLHANDLE callHandle;
52 VBOXHGCMSVCPARM *paParms;
53 } asyncRead;
54
55 struct {
56 void *pv;
57 uint32_t cb;
58 uint32_t u32Format;
59 } data;
60
61 uint32_t u32AvailableFormats;
62 uint32_t u32RequestedFormat;
63
64} VBOXCLIPBOARDCLIENTDATA, *PVBOXCLIPBOARDCLIENTDATA;
65
66/*
67 * The service functions. Locking is between the service thread and the platform dependent windows thread.
68 */
69void vboxSvcClipboardReportMsg (VBOXCLIPBOARDCLIENTDATA *pClient, uint32_t u32Msg, uint32_t u32Formats);
70void vboxSvcClipboardCompleteReadData(VBOXCLIPBOARDCLIENTDATA *pClient, int rc, uint32_t cbActual);
71
72/*
73 * Platform dependent functions.
74 */
75int vboxClipboardInit (void);
76void vboxClipboardDestroy (void);
77
78int vboxClipboardConnect (VBOXCLIPBOARDCLIENTDATA *pClient, bool fHeadless);
79void vboxClipboardDisconnect (VBOXCLIPBOARDCLIENTDATA *pClient);
80void vboxClipboardFormatAnnounce (VBOXCLIPBOARDCLIENTDATA *pClient, uint32_t u32Formats);
81int vboxClipboardReadData (VBOXCLIPBOARDCLIENTDATA *pClient, uint32_t u32Format, void *pv, uint32_t cb, uint32_t *pcbActual);
82void vboxClipboardWriteData (VBOXCLIPBOARDCLIENTDATA *pClient, void *pv, uint32_t cb, uint32_t u32Format);
83
84int vboxClipboardSync (VBOXCLIPBOARDCLIENTDATA *pClient);
85
86/* Host unit testing interface */
87#ifdef UNIT_TEST
88uint32_t TestClipSvcGetMode(void);
89#endif
90
91#endif /* !VBOX_INCLUDED_SRC_SharedClipboard_VBoxClipboard_h */
92
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