FreeRDP
Loading...
Searching...
No Matches
rdpemt.h
1
17
18#ifndef FREERDP_LIB_CORE_RDPEMT_H
19#define FREERDP_LIB_CORE_RDPEMT_H
20
21#include <winpr/wtypes.h>
22#include <winpr/winsock.h>
23#include <winpr/wlog.h>
24#include <winpr/stream.h>
25#include <winpr/collections.h>
26
27#include <freerdp/config.h>
28#include <freerdp/api.h>
29#if defined(WITH_RDPEUDP)
30#include "udplistener.h"
31#endif
32
38typedef struct rdp_emt rdpEmt;
39
40typedef enum
41{
42 RDPEMT_EVENT_READY,
43 RDPEMT_EVENT_FAILED,
44 RDPEMT_EVENT_DATA,
45 RDPEMT_EVENT_AUTODETECT,
48 RDPEMT_EVENT_SYN_RECEIVED,
49 RDPEMT_EVENT_WRITABLE,
50 RDPEMT_EVENT_RESPONSE_DUE
51} RDPEMT_EVENT;
52
55#define RDPEMT_SERVER_RESPONSE_TIMEOUT_MS 30000
56
59typedef void (*rdpEmtEventFn)(void* custom, rdpEmt* emt, RDPEMT_EVENT event, const BYTE* data,
60 size_t length);
61
64typedef BOOL (*rdpEmtReceiverFn)(void* custom, wStream* s);
65
68typedef BOOL (*rdpEmtHoldFn)(void* custom);
69
70#if defined(WITH_RDPEUDP)
71
73WINPR_ATTR_NODISCARD
74FREERDP_LOCAL BOOL rdpemt_is_supported(void);
75
76FREERDP_LOCAL void rdpemt_free(rdpEmt* emt);
77
85WINPR_ATTR_MALLOC(rdpemt_free, 1)
86WINPR_ATTR_NODISCARD
87FREERDP_LOCAL rdpEmt* rdpemt_new(wLog* log, UINT32 requestId, const BYTE* cookie,
88 const char* hostname, const BYTE* publicKey,
89 size_t publicKeyLength, rdpEmtEventFn callback, void* custom);
90
91WINPR_ATTR_NODISCARD
92FREERDP_LOCAL BOOL rdpemt_start(rdpEmt* emt, const struct sockaddr* addr, size_t addrlen);
93
94#if defined(WITH_RDPEUDP_SERVER)
101WINPR_ATTR_MALLOC(rdpemt_free, 1)
102WINPR_ATTR_NODISCARD
103FREERDP_LOCAL rdpEmt* rdpemt_new_server(wLog* log, UINT32 requestId, const BYTE* cookie,
104 struct rdp_certificate* cert,
105 const struct rdp_private_key* key, BOOL manual,
106 rdpEmtEventFn callback, void* custom);
107#endif
108
114WINPR_ATTR_NODISCARD
115FREERDP_LOCAL BOOL rdpemt_set_tls_settings(rdpEmt* emt, UINT16 minVersion, UINT16 maxVersion,
116 UINT32 secLevel, const char* ciphers);
117
121FREERDP_LOCAL void rdpemt_set_receive_hold(rdpEmt* emt, rdpEmtHoldFn hold);
122
124WINPR_ATTR_NODISCARD
125FREERDP_LOCAL BOOL rdpemt_has_failed(rdpEmt* emt);
126
127#if defined(WITH_RDPEUDP_SERVER)
129WINPR_ATTR_NODISCARD
130FREERDP_LOCAL rdpUdpFlow* rdpemt_get_flow(const rdpEmt* emt);
131#endif
132
134FREERDP_LOCAL void rdpemt_get_send_state(rdpEmt* emt, rdpUdpSendState* state);
135
138FREERDP_LOCAL void rdpemt_set_send_limit(rdpEmt* emt, size_t limit);
139
141WINPR_ATTR_NODISCARD
142FREERDP_LOCAL BOOL rdpemt_send_data(rdpEmt* emt, const BYTE* data, size_t length);
143
146WINPR_ATTR_NODISCARD
147FREERDP_LOCAL BOOL rdpemt_send_subheader(rdpEmt* emt, const BYTE* subHeader, size_t length);
148
150WINPR_ATTR_NODISCARD
151FREERDP_LOCAL BOOL rdpemt_flush(rdpEmt* emt);
152
153WINPR_ATTR_NODISCARD
154FREERDP_LOCAL UINT32 rdpemt_get_request_id(const rdpEmt* emt);
155
157WINPR_ATTR_NODISCARD
158FREERDP_LOCAL UINT32 rdpemt_get_serial(const rdpEmt* emt);
159
165WINPR_ATTR_NODISCARD
166FREERDP_LOCAL BOOL rdpemt_set_receiver(rdpEmt* emt, rdpEmtReceiverFn receiver, void* custom,
167 wQueue* pending);
168
171FREERDP_LOCAL void rdpemt_clear_receiver(rdpEmt* emt);
172
175WINPR_ATTR_NODISCARD
176FREERDP_LOCAL UINT32 rdpemt_take_direct_bytes(rdpEmt* emt);
177
178#else
179
180/* Built without UDP multitransport: requests are declined and no tunnel ever exists. */
181WINPR_ATTR_NODISCARD
182static inline BOOL rdpemt_is_supported(void)
183{
184 return FALSE;
185}
186
187static inline void rdpemt_free(WINPR_ATTR_UNUSED rdpEmt* emt)
188{
189}
190
191WINPR_ATTR_NODISCARD
192static inline rdpEmt*
193rdpemt_new(WINPR_ATTR_UNUSED wLog* log, WINPR_ATTR_UNUSED UINT32 requestId,
194 WINPR_ATTR_UNUSED const BYTE* cookie, WINPR_ATTR_UNUSED const char* hostname,
195 WINPR_ATTR_UNUSED const BYTE* publicKey, WINPR_ATTR_UNUSED size_t publicKeyLength,
196 WINPR_ATTR_UNUSED rdpEmtEventFn callback, WINPR_ATTR_UNUSED void* custom)
197{
198 return nullptr;
199}
200
201WINPR_ATTR_NODISCARD
202static inline BOOL rdpemt_start(WINPR_ATTR_UNUSED rdpEmt* emt,
203 WINPR_ATTR_UNUSED const struct sockaddr* addr,
204 WINPR_ATTR_UNUSED size_t addrlen)
205{
206 return FALSE;
207}
208
209WINPR_ATTR_NODISCARD
210static inline BOOL rdpemt_send_data(WINPR_ATTR_UNUSED rdpEmt* emt,
211 WINPR_ATTR_UNUSED const BYTE* data,
212 WINPR_ATTR_UNUSED size_t length)
213{
214 return FALSE;
215}
216
217WINPR_ATTR_NODISCARD
218static inline BOOL rdpemt_send_subheader(WINPR_ATTR_UNUSED rdpEmt* emt,
219 WINPR_ATTR_UNUSED const BYTE* subHeader,
220 WINPR_ATTR_UNUSED size_t length)
221{
222 return FALSE;
223}
224
225WINPR_ATTR_NODISCARD
226static inline UINT32 rdpemt_get_request_id(WINPR_ATTR_UNUSED const rdpEmt* emt)
227{
228 return 0;
229}
230
231WINPR_ATTR_NODISCARD
232static inline UINT32 rdpemt_get_serial(WINPR_ATTR_UNUSED const rdpEmt* emt)
233{
234 return 0;
235}
236
237WINPR_ATTR_NODISCARD
238static inline BOOL rdpemt_set_receiver(WINPR_ATTR_UNUSED rdpEmt* emt,
239 WINPR_ATTR_UNUSED rdpEmtReceiverFn receiver,
240 WINPR_ATTR_UNUSED void* custom,
241 WINPR_ATTR_UNUSED wQueue* pending)
242{
243 return FALSE;
244}
245
246static inline void rdpemt_clear_receiver(WINPR_ATTR_UNUSED rdpEmt* emt)
247{
248}
249
250WINPR_ATTR_NODISCARD
251static inline BOOL rdpemt_flush(WINPR_ATTR_UNUSED rdpEmt* emt)
252{
253 return FALSE;
254}
255
256#endif
257
258#endif /* FREERDP_LIB_CORE_RDPEMT_H */
Comprehensive UDP send state information, including additional metrics.
Definition udplistener.h:71