1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
|
/* $Id: RemoteUSBBackend.h $ */
/** @file
*
* VirtualBox Remote USB backend
*/
/*
* Copyright (C) 2006-2023 Oracle and/or its affiliates.
*
* This file is part of VirtualBox base platform packages, as
* available from https://www.virtualbox.org.
*
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU General Public License
* as published by the Free Software Foundation, in version 3 of the
* License.
*
* This program is distributed in the hope that it will be useful, but
* WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, see <https://www.gnu.org/licenses>.
*
* SPDX-License-Identifier: GPL-3.0-only
*/
#ifndef MAIN_INCLUDED_RemoteUSBBackend_h
#define MAIN_INCLUDED_RemoteUSBBackend_h
#ifndef RT_WITHOUT_PRAGMA_ONCE
# pragma once
#endif
#include "RemoteUSBDeviceImpl.h"
#include <VBox/RemoteDesktop/VRDE.h>
#include <VBox/vrdpusb.h>
#include <iprt/critsect.h>
//typedef enum
//{
// RDLIdle = 0,
// RDLReqSent,
// RDLObtained
//} RDLState;
class Console;
class ConsoleVRDPServer;
DECLCALLBACK(int) USBClientResponseCallback (void *pv, uint32_t u32ClientId, uint8_t code, const void *pvRet, uint32_t cbRet);
/* How many remote devices can be attached to a remote client.
* Normally a client computer has 2-8 physical USB ports, so 16 devices
* should be usually enough.
*/
#define VRDP_MAX_USB_DEVICES_PER_CLIENT (16)
class RemoteUSBBackendListable
{
public:
RemoteUSBBackendListable *pNext;
RemoteUSBBackendListable *pPrev;
RemoteUSBBackendListable() : pNext (NULL), pPrev (NULL) {};
};
class RemoteUSBBackend: public RemoteUSBBackendListable
{
public:
RemoteUSBBackend(Console *console, ConsoleVRDPServer *server, uint32_t u32ClientId);
~RemoteUSBBackend();
uint32_t ClientId (void) { return mu32ClientId; }
void AddRef (void);
void Release (void);
REMOTEUSBCALLBACK *GetBackendCallbackPointer (void) { return &mCallback; }
void NotifyDelete (void);
void PollRemoteDevices (void);
public: /* Functions for internal use. */
ConsoleVRDPServer *VRDPServer (void) { return mServer; };
bool pollingEnabledURB (void) { return mfPollURB; }
int saveDeviceList (const void *pvList, uint32_t cbList);
int negotiateResponse (const VRDEUSBREQNEGOTIATERET *pret, uint32_t cbRet);
int reapURB (const void *pvBody, uint32_t cbBody);
void request (void);
void release (void);
PREMOTEUSBDEVICE deviceFromId (VRDEUSBDEVID id);
void addDevice (PREMOTEUSBDEVICE pDevice);
void removeDevice (PREMOTEUSBDEVICE pDevice);
bool addUUID (const Guid *pUuid);
bool findUUID (const Guid *pUuid);
void removeUUID (const Guid *pUuid);
private:
Console *mConsole;
ConsoleVRDPServer *mServer;
int cRefs;
uint32_t mu32ClientId;
RTCRITSECT mCritsect;
REMOTEUSBCALLBACK mCallback;
bool mfHasDeviceList;
void *mpvDeviceList;
uint32_t mcbDeviceList;
typedef enum {
PollRemoteDevicesStatus_Negotiate,
PollRemoteDevicesStatus_WaitNegotiateResponse,
PollRemoteDevicesStatus_SendRequest,
PollRemoteDevicesStatus_WaitResponse,
PollRemoteDevicesStatus_Dereferenced
} PollRemoteDevicesStatus;
PollRemoteDevicesStatus menmPollRemoteDevicesStatus;
bool mfPollURB;
PREMOTEUSBDEVICE mpDevices;
bool mfWillBeDeleted;
Guid aGuids[VRDP_MAX_USB_DEVICES_PER_CLIENT];
/* VRDP_USB_VERSION_2: the client version. */
uint32_t mClientVersion;
/* VRDP_USB_VERSION_3: the client sends VRDE_USB_REQ_DEVICE_LIST_EXT_RET. */
bool mfDescExt;
};
#endif /* !MAIN_INCLUDED_RemoteUSBBackend_h */
/* vi: set tabstop=4 shiftwidth=4 expandtab: */
|
