FreeRDP
Loading...
Searching...
No Matches
include/freerdp/server/shadow.h
1
20#ifndef FREERDP_SERVER_SHADOW_H
21#define FREERDP_SERVER_SHADOW_H
22
23#include <freerdp/api.h>
24#include <freerdp/types.h>
25
26#include <freerdp/freerdp.h>
27#include <freerdp/settings.h>
28#include <freerdp/listener.h>
29
30#include <freerdp/channels/wtsvc.h>
31#include <freerdp/channels/channels.h>
32
33#include <freerdp/server/encomsp.h>
34#include <freerdp/server/remdesk.h>
35#include <freerdp/server/rdpsnd.h>
36#if defined(CHANNEL_AUDIN_SERVER)
37#include <freerdp/server/audin.h>
38#endif
39#include <freerdp/server/rdpgfx.h>
40
41#include <freerdp/codec/color.h>
42#include <freerdp/codec/region.h>
43
44#include <winpr/crt.h>
45#include <winpr/synch.h>
46#include <winpr/collections.h>
47#include <winpr/cmdline.h>
48
49#ifdef __cplusplus
50extern "C"
51{
52#endif
53
54 typedef struct rdp_shadow_client rdpShadowClient;
55 typedef struct rdp_shadow_server rdpShadowServer;
56 typedef struct rdp_shadow_screen rdpShadowScreen;
57 typedef struct rdp_shadow_surface rdpShadowSurface;
58 typedef struct rdp_shadow_encoder rdpShadowEncoder;
59 typedef struct rdp_shadow_capture rdpShadowCapture;
60 typedef struct rdp_shadow_subsystem rdpShadowSubsystem;
61 typedef struct rdp_shadow_multiclient_event rdpShadowMultiClientEvent;
62
63 typedef struct S_RDP_SHADOW_ENTRY_POINTS RDP_SHADOW_ENTRY_POINTS;
64 typedef int (*pfnShadowSubsystemEntry)(RDP_SHADOW_ENTRY_POINTS* pEntryPoints);
65
66 typedef rdpShadowSubsystem* (*pfnShadowSubsystemNew)(void);
67 typedef void (*pfnShadowSubsystemFree)(rdpShadowSubsystem* subsystem);
68
69 typedef int (*pfnShadowSubsystemInit)(rdpShadowSubsystem* subsystem);
70 typedef int (*pfnShadowSubsystemUninit)(rdpShadowSubsystem* subsystem);
71
72 typedef int (*pfnShadowSubsystemStart)(rdpShadowSubsystem* subsystem);
73 typedef int (*pfnShadowSubsystemStop)(rdpShadowSubsystem* subsystem);
74
75 typedef UINT32 (*pfnShadowEnumMonitors)(MONITOR_DEF* monitors, UINT32 maxMonitors);
76
77 typedef int (*pfnShadowAuthenticate)(rdpShadowSubsystem* subsystem, rdpShadowClient* client,
78 const char* user, const char* domain,
79 const char* password);
80 typedef BOOL (*pfnShadowClientConnect)(rdpShadowSubsystem* subsystem, rdpShadowClient* client);
81 typedef void (*pfnShadowClientDisconnect)(rdpShadowSubsystem* subsystem,
82 rdpShadowClient* client);
83 typedef BOOL (*pfnShadowClientCapabilities)(rdpShadowSubsystem* subsystem,
84 rdpShadowClient* client);
85
86 typedef BOOL (*pfnShadowSynchronizeEvent)(rdpShadowSubsystem* subsystem,
87 rdpShadowClient* client, UINT32 flags);
88 typedef BOOL (*pfnShadowKeyboardEvent)(rdpShadowSubsystem* subsystem, rdpShadowClient* client,
89 UINT16 flags, UINT8 code);
90 typedef BOOL (*pfnShadowUnicodeKeyboardEvent)(rdpShadowSubsystem* subsystem,
91 rdpShadowClient* client, UINT16 flags,
92 UINT16 code);
93 typedef BOOL (*pfnShadowMouseEvent)(rdpShadowSubsystem* subsystem, rdpShadowClient* client,
94 UINT16 flags, UINT16 x, UINT16 y);
95 typedef BOOL (*pfnShadowRelMouseEvent)(rdpShadowSubsystem* subsystem, rdpShadowClient* client,
96 UINT16 flags, INT16 xDelta,
97 INT16 yDelta);
99 typedef BOOL (*pfnShadowExtendedMouseEvent)(rdpShadowSubsystem* subsystem,
100 rdpShadowClient* client, UINT16 flags, UINT16 x,
101 UINT16 y);
102
103 typedef BOOL (*pfnShadowChannelAudinServerReceiveSamples)(rdpShadowSubsystem* subsystem,
104 rdpShadowClient* client,
105 const AUDIO_FORMAT* format,
106 wStream* data);
107
108 struct rdp_shadow_client
109 {
110 rdpContext context;
111
112 HANDLE thread;
113 BOOL activated;
114 BOOL first_frame;
115 BOOL inLobby;
116 BOOL mayView;
117 BOOL mayInteract;
118 BOOL suppressOutput;
119 UINT16 surfaceId;
120 wMessageQueue* MsgQueue;
121 CRITICAL_SECTION lock;
122 REGION16 invalidRegion;
123 rdpShadowServer* server;
124 rdpShadowEncoder* encoder;
125 rdpShadowSubsystem* subsystem;
126
127 UINT32 pointerX;
128 UINT32 pointerY;
129
130 HANDLE vcm;
131 EncomspServerContext* encomsp;
132 RemdeskServerContext* remdesk;
133 RdpsndServerContext* rdpsnd;
134#if defined(CHANNEL_AUDIN_SERVER)
135 audin_server_context* audin;
136#endif
137 RdpgfxServerContext* rdpgfx;
138
139 BOOL resizeRequested;
140 UINT32 resizeWidth;
141 UINT32 resizeHeight;
142 BOOL areGfxCapsReady;
143 RDPGFX_CAPSET confirmedCaps;
144 };
145
146 struct rdp_shadow_server
147 {
148 void* ext;
149 HANDLE thread;
150 HANDLE StopEvent;
151 wArrayList* clients;
152 rdpSettings* settings;
153 rdpShadowScreen* screen;
154 rdpShadowSurface* surface;
155 rdpShadowSurface* lobby;
156 rdpShadowCapture* capture;
157 rdpShadowSubsystem* subsystem;
158
159 DWORD port;
160 BOOL mayView;
161 BOOL mayInteract;
162 BOOL shareSubRect;
163 BOOL authentication;
164 UINT32 selectedMonitor;
165 RECTANGLE_16 subRect;
166
167 /* Codec settings */
168 RLGR_MODE rfxMode; /* unused */
169 H264_RATECONTROL_MODE h264RateControlMode;
170 UINT32 h264BitRate;
171 UINT32 h264FrameRate;
172 UINT32 h264QP;
173
174 char* ipcSocket;
175 char* ConfigPath;
176 char* CertificateFile;
177 char* PrivateKeyFile;
178 CRITICAL_SECTION lock;
179 freerdp_listener* listener;
180
181 size_t maxClientsConnected;
182 BOOL SupportMultiRectBitmapUpdates;
183 BOOL ShowMouseCursor;
184 };
185
186 struct rdp_shadow_surface
187 {
188 rdpShadowServer* server;
189
190 UINT16 x;
191 UINT16 y;
192 UINT32 width;
193 UINT32 height;
194 UINT32 scanline;
195 DWORD format;
196 BYTE* data;
197
198 CRITICAL_SECTION lock;
199 REGION16 invalidRegion;
200 };
201
202 struct S_RDP_SHADOW_ENTRY_POINTS
203 {
204 WINPR_ATTR_NODISCARD pfnShadowSubsystemNew New;
205 pfnShadowSubsystemFree Free;
206
207 WINPR_ATTR_NODISCARD pfnShadowSubsystemInit Init;
208 pfnShadowSubsystemUninit Uninit;
209
210 WINPR_ATTR_NODISCARD pfnShadowSubsystemStart Start;
211 pfnShadowSubsystemStop Stop;
212
213 WINPR_ATTR_NODISCARD pfnShadowEnumMonitors EnumMonitors;
214 };
215
216 struct rdp_shadow_subsystem
217 {
218 RDP_SHADOW_ENTRY_POINTS ep;
219 HANDLE event;
220 UINT32 numMonitors;
221 UINT32 captureFrameRate;
222 UINT32 selectedMonitor;
223 MONITOR_DEF monitors[16];
224 MONITOR_DEF virtualScreen;
225
226 /* This event indicates that we have graphic change */
227 /* such as screen update and resize. It should not be */
228 /* used by subsystem implementation directly */
229 rdpShadowMultiClientEvent* updateEvent;
230
231 wMessagePipe* MsgPipe;
232 UINT32 pointerX;
233 UINT32 pointerY;
234
235 AUDIO_FORMAT* rdpsndFormats;
236 size_t nRdpsndFormats;
237 AUDIO_FORMAT* audinFormats;
238 size_t nAudinFormats;
239
240 WINPR_ATTR_NODISCARD pfnShadowSynchronizeEvent SynchronizeEvent;
241 WINPR_ATTR_NODISCARD pfnShadowKeyboardEvent KeyboardEvent;
242 WINPR_ATTR_NODISCARD pfnShadowUnicodeKeyboardEvent UnicodeKeyboardEvent;
243 WINPR_ATTR_NODISCARD pfnShadowMouseEvent MouseEvent;
244 WINPR_ATTR_NODISCARD pfnShadowExtendedMouseEvent ExtendedMouseEvent;
245 WINPR_ATTR_NODISCARD pfnShadowChannelAudinServerReceiveSamples AudinServerReceiveSamples;
246
247 WINPR_ATTR_NODISCARD pfnShadowAuthenticate Authenticate;
248 WINPR_ATTR_NODISCARD pfnShadowClientConnect ClientConnect;
249 pfnShadowClientDisconnect ClientDisconnect;
250 WINPR_ATTR_NODISCARD pfnShadowClientCapabilities ClientCapabilities;
251
252 rdpShadowServer* server;
253
254 WINPR_ATTR_NODISCARD pfnShadowRelMouseEvent RelMouseEvent;
255 };
256
257/* Definition of message between subsystem and clients */
258#define SHADOW_MSG_IN_REFRESH_REQUEST_ID 1001
259
260 typedef struct S_SHADOW_MSG_OUT SHADOW_MSG_OUT;
261 typedef void (*MSG_OUT_FREE_FN)(UINT32 id,
262 SHADOW_MSG_OUT* msg); /* function to free SHADOW_MSG_OUT */
263
264 struct S_SHADOW_MSG_OUT
265 {
266 int refCount;
267 MSG_OUT_FREE_FN Free;
268 };
269
270#define SHADOW_MSG_OUT_POINTER_POSITION_UPDATE_ID 2001
271#define SHADOW_MSG_OUT_POINTER_ALPHA_UPDATE_ID 2002
272#define SHADOW_MSG_OUT_AUDIO_OUT_SAMPLES_ID 2003
273#define SHADOW_MSG_OUT_AUDIO_OUT_VOLUME_ID 2004
274
275 typedef struct
276 {
277 SHADOW_MSG_OUT common;
278 UINT32 xPos;
279 UINT32 yPos;
280 } SHADOW_MSG_OUT_POINTER_POSITION_UPDATE;
281
282 typedef struct
283 {
284 SHADOW_MSG_OUT common;
285 UINT32 xHot;
286 UINT32 yHot;
287 UINT32 width;
288 UINT32 height;
289 UINT32 lengthAndMask;
290 UINT32 lengthXorMask;
291 BYTE* xorMaskData;
292 BYTE* andMaskData;
293 } SHADOW_MSG_OUT_POINTER_ALPHA_UPDATE;
294
295 typedef struct
296 {
297 SHADOW_MSG_OUT common;
298 AUDIO_FORMAT* audio_format;
299 void* buf;
300 size_t nFrames;
301 UINT16 wTimestamp;
302 } SHADOW_MSG_OUT_AUDIO_OUT_SAMPLES;
303
304 typedef struct
305 {
306 SHADOW_MSG_OUT common;
307 UINT16 left;
308 UINT16 right;
309 } SHADOW_MSG_OUT_AUDIO_OUT_VOLUME;
310
311 FREERDP_API void shadow_subsystem_set_entry_builtin(const char* name);
312 FREERDP_API void shadow_subsystem_set_entry(pfnShadowSubsystemEntry pEntry);
313
314#if !defined(WITHOUT_FREERDP_3x_DEPRECATED)
315 WINPR_DEPRECATED_VAR(
316 "[since 3.4.0] Use shadow_subsystem_pointer_convert_alpha_pointer_data_to_format instead",
317 WINPR_ATTR_NODISCARD FREERDP_API int shadow_subsystem_pointer_convert_alpha_pointer_data(
318 const BYTE* WINPR_RESTRICT pixels, BOOL premultiplied, UINT32 width, UINT32 height,
319 SHADOW_MSG_OUT_POINTER_ALPHA_UPDATE* WINPR_RESTRICT pointerColor));
320#endif
321
335 WINPR_ATTR_NODISCARD
336 FREERDP_API int shadow_subsystem_pointer_convert_alpha_pointer_data_to_format(
337 const BYTE* WINPR_RESTRICT pixels, UINT32 format, BOOL premultiplied, UINT32 width,
338 UINT32 height, SHADOW_MSG_OUT_POINTER_ALPHA_UPDATE* WINPR_RESTRICT pointerColor);
339
340 WINPR_ATTR_NODISCARD
341 FREERDP_API int shadow_server_parse_command_line(rdpShadowServer* server, int argc, char** argv,
342 COMMAND_LINE_ARGUMENT_A* cargs);
343
344 WINPR_ATTR_NODISCARD
345 FREERDP_API int shadow_server_command_line_status_print(rdpShadowServer* server, int argc,
346 char** argv, int status,
347 const COMMAND_LINE_ARGUMENT_A* cargs);
348
349 WINPR_ATTR_NODISCARD
350 FREERDP_API int shadow_server_start(rdpShadowServer* server);
351
352 FREERDP_API int shadow_server_stop(rdpShadowServer* server);
353
354 WINPR_ATTR_NODISCARD
355 FREERDP_API int shadow_server_init(rdpShadowServer* server);
356
357 FREERDP_API int shadow_server_uninit(rdpShadowServer* server);
358
359 WINPR_ATTR_NODISCARD
360 FREERDP_API UINT32 shadow_enum_monitors(MONITOR_DEF* monitors, UINT32 maxMonitors);
361
362 FREERDP_API void shadow_server_free(rdpShadowServer* server);
363
364 WINPR_ATTR_MALLOC(shadow_server_free, 1)
365 WINPR_ATTR_NODISCARD
366 FREERDP_API rdpShadowServer* shadow_server_new(void);
367
368 WINPR_ATTR_NODISCARD
369 FREERDP_API int shadow_capture_align_clip_rect(RECTANGLE_16* rect, const RECTANGLE_16* clip);
370
371#if !defined(WITHOUT_FREERDP_3x_DEPRECATED)
372 WINPR_DEPRECATED_VAR("[since 3.4.0] Use shadow_capture_compare_with_format",
373 WINPR_ATTR_NODISCARD FREERDP_API int shadow_capture_compare(
374 const BYTE* WINPR_RESTRICT pData1, UINT32 nStep1, UINT32 nWidth,
375 UINT32 nHeight, const BYTE* WINPR_RESTRICT pData2, UINT32 nStep2,
376 RECTANGLE_16* WINPR_RESTRICT rect));
377#endif
378
395 WINPR_ATTR_NODISCARD
396 FREERDP_API int shadow_capture_compare_with_format(const BYTE* WINPR_RESTRICT pData1,
397 UINT32 format1, UINT32 nStep1, UINT32 nWidth,
398 UINT32 nHeight,
399 const BYTE* WINPR_RESTRICT pData2,
400 UINT32 format2, UINT32 nStep2,
401 RECTANGLE_16* WINPR_RESTRICT rect);
402
403 FREERDP_API void shadow_subsystem_frame_update(rdpShadowSubsystem* subsystem);
404
405 WINPR_ATTR_NODISCARD
406 FREERDP_API BOOL shadow_client_post_msg(rdpShadowClient* client, void* context, UINT32 type,
407 SHADOW_MSG_OUT* msg, void* lParam);
408
409 WINPR_ATTR_NODISCARD
410 FREERDP_API int shadow_client_boardcast_msg(rdpShadowServer* server, void* context, UINT32 type,
411 SHADOW_MSG_OUT* msg, void* lParam);
412
413 WINPR_ATTR_NODISCARD
414 FREERDP_API int shadow_client_boardcast_quit(rdpShadowServer* server, int nExitCode);
415
416 WINPR_ATTR_NODISCARD
417 FREERDP_API UINT32 shadow_encoder_preferred_fps(rdpShadowEncoder* encoder);
418
419 WINPR_ATTR_NODISCARD
420 FREERDP_API UINT32 shadow_encoder_inflight_frames(rdpShadowEncoder* encoder);
421
422 WINPR_ATTR_NODISCARD
423 FREERDP_API BOOL shadow_screen_resize(rdpShadowScreen* screen);
424
425#ifdef __cplusplus
426}
427#endif
428
429#endif /* FREERDP_SERVER_SHADOW_H */
MONITOR_DEF
Definition settings_types.h:413
AUDIO_FORMAT
Definition audio.h:35
COMMAND_LINE_ARGUMENT_A
Definition winpr/include/winpr/cmdline.h:100
RDPGFX_CAPSET
Definition channels/rdpgfx.h:117
RECTANGLE_16
Definition types.h:109
RTL_CRITICAL_SECTION
Definition include/winpr/synch.h:160
SHADOW_MSG_OUT_AUDIO_OUT_SAMPLES
Definition include/freerdp/server/shadow.h:296
SHADOW_MSG_OUT_AUDIO_OUT_VOLUME
Definition include/freerdp/server/shadow.h:305
SHADOW_MSG_OUT_POINTER_ALPHA_UPDATE
Definition include/freerdp/server/shadow.h:283
SHADOW_MSG_OUT_POINTER_POSITION_UPDATE
Definition include/freerdp/server/shadow.h:276
S_RDP_SHADOW_ENTRY_POINTS
Definition include/freerdp/server/shadow.h:203
S_SHADOW_MSG_OUT
Definition include/freerdp/server/shadow.h:265
rdp_shadow_capture
Definition shadow_capture.h:29
rdp_shadow_client
Definition include/freerdp/server/shadow.h:109
rdp_shadow_client::confirmedCaps
RDPGFX_CAPSET confirmedCaps
Definition include/freerdp/server/shadow.h:143
rdp_shadow_encoder
Definition shadow_encoder.h:31
rdp_shadow_screen
Definition shadow_screen.h:28
rdp_shadow_server
Definition include/freerdp/server/shadow.h:147
rdp_shadow_server::ShowMouseCursor
BOOL ShowMouseCursor
Definition include/freerdp/server/shadow.h:183
rdp_shadow_subsystem
Definition include/freerdp/server/shadow.h:217
rdp_shadow_surface
Definition include/freerdp/server/shadow.h:187