1 
2 /*
3  * FreeSWITCH Modular Media Switching Software Library / Soft-Switch Application
4  * Copyright (C) 2005-2014, Anthony Minessale II <anthm@freeswitch.org>
5  *
6  * Version: MPL 1.1
7  *
8  * The contents of this file are subject to the Mozilla Public License Version
9  * 1.1 (the "License"); you may not use this file except in compliance with
10  * the License. You may obtain a copy of the License at
11  * http://www.mozilla.org/MPL/
12  *
13  * Software distributed under the License is distributed on an "AS IS" basis,
14  * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
15  * for the specific language governing rights and limitations under the
16  * License.
17  *
18  * The Original Code is FreeSWITCH Modular Media Switching Software Library / Soft-Switch Application
19  *
20  * The Initial Developer of the Original Code is
21  * Anthony Minessale II <anthm@freeswitch.org>
22  * Portions created by the Initial Developer are Copyright (C)
23  * the Initial Developer. All Rights Reserved.
24  *
25  * Contributor(s):
26  *
27  * Anthony Minessale II <anthm@freeswitch.org>
28  *
29  * switch_core_media.c -- Core Media
30  *
31  */
32 
33 #ifndef SWITCH_CORE_MEDIA_H
34 #define SWITCH_CORE_MEDIA_H
35 
36 
37 #include <switch.h>
38 #include <switch_msrp.h>
39 
40 SWITCH_BEGIN_EXTERN_C
41 
42 #define SWITCH_MAX_CAND_ACL 25
43 #define SWITCH_NO_CRYPTO_TAG -1
44 
45 typedef enum {
46 	DTMF_AUTO,
47 	DTMF_2833,
48 	DTMF_INFO,
49 	DTMF_NONE
50 } switch_core_media_dtmf_t;
51 
52 typedef enum {
53 	SM_NDLB_ALLOW_BAD_IANANAME = (1 << 0),
54 	SM_NDLB_ALLOW_NONDUP_SDP = (1 << 1),
55 	SM_NDLB_ALLOW_CRYPTO_IN_AVP = (1 << 2),
56 	SM_NDLB_DISABLE_SRTP_AUTH = (1 << 3),
57 	SM_NDLB_SENDRECV_IN_SESSION = (1 << 4),
58 	SM_NDLB_NEVER_PATCH_REINVITE = (1 << 5)
59 } switch_core_media_NDLB_t;
60 
61 typedef enum {
62 	SCMF_RUNNING,
63 	SCMF_DISABLE_TRANSCODING,
64 	SCMF_AUTOFIX_TIMING,
65 	SCMF_CODEC_GREEDY,
66 	SCMF_CODEC_SCROOGE,
67 	SCMF_DISABLE_HOLD,
68 	SCMF_SUPPRESS_CNG,
69 	SCMF_DISABLE_RTP_AUTOADJ,
70 	SCMF_PASS_RFC2833,
71 	SCMF_AUTOFLUSH,
72 	SCMF_REWRITE_TIMESTAMPS,
73 	SCMF_RTP_AUTOFLUSH_DURING_BRIDGE,
74 	SCMF_MULTI_ANSWER_AUDIO,
75 	SCMF_MULTI_ANSWER_VIDEO,
76 	SCMF_RECV_SDP,
77 	SCMF_MAX
78 } switch_core_media_flag_t;
79 
80 struct switch_media_handle_s;
81 
82 typedef enum {
83 	STUN_FLAG_SET = (1 << 0),
84 	STUN_FLAG_PING = (1 << 1),
85 	STUN_FLAG_FUNNY = (1 << 2)
86 } STUNFLAGS;
87 
88 typedef enum {
89 	VAD_IN = (1 << 0),
90 	VAD_OUT = (1 << 1)
91 } switch_core_media_vflag_t;
92 
93 typedef struct switch_core_media_params_s {
94 	uint32_t rtp_timeout_sec;
95 	uint32_t rtp_hold_timeout_sec;
96 	uint32_t dtmf_delay;
97 	uint32_t codec_flags;
98 
99 	switch_core_media_NDLB_t ndlb;
100 	switch_rtp_bug_flag_t auto_rtp_bugs;
101 
102 	char *inbound_codec_string;
103 	char *outbound_codec_string;
104 
105 	char *timer_name;
106 
107 	char *remote_sdp_str;
108 	char *early_sdp;
109 	char *local_sdp_str;
110 	char *last_sdp_str;
111 	char *last_sdp_response;
112 	char *prev_sdp_str;
113 	char *prev_sdp_response;
114 
115 	char *stun_ip;
116 	switch_port_t stun_port;
117 	uint32_t stun_flags;
118 
119 	char *jb_msec;
120 
121 	switch_core_media_vflag_t vflags;
122 
123 	switch_rtp_bug_flag_t manual_rtp_bugs;
124 	switch_rtp_bug_flag_t manual_video_rtp_bugs;
125 	switch_rtp_bug_flag_t manual_text_rtp_bugs;
126 
127 	char *rtcp_audio_interval_msec;
128 	char *rtcp_video_interval_msec;
129 	char *rtcp_text_interval_msec;
130 
131 
132 	char *extrtpip;
133 	char *rtpip;
134 	char *rtpip4;
135 	char *rtpip6;
136 
137 
138 	char *remote_ip;
139 	int remote_port;
140 
141 	char *extsipip;
142 	char *local_network;
143 
144 	char *sipip;
145 
146 	char *sdp_username;
147 
148 	switch_payload_t te;
149 	switch_payload_t recv_te;
150 	unsigned long te_rate;
151 	unsigned long cng_rate;
152 
153 	char *adv_sdp_audio_ip;
154 
155     int num_codecs;
156 	int hold_laps;
157 	switch_core_media_dtmf_t dtmf_type;
158 	switch_payload_t cng_pt;
159 
160 
161 	/* a core_video_thread will be started automatically
162 	   when uses rtp based media,
163 	   external_video_source should be set to SWITCH_TRUE and
164 	   switch_core_session_start_video_thread()
165 	   should be explicitly called to start the video thread
166 	   if uses the media handle for non-rtp based media
167 	*/
168 
169 	switch_bool_t external_video_source;
170 
171 	uint32_t video_key_freq;
172 	uint32_t video_key_first;
173 
174 	switch_thread_t *video_write_thread;
175 
176 } switch_core_media_params_t;
177 
switch_media_type2str(switch_media_type_t type)178 static inline const char *switch_media_type2str(switch_media_type_t type)
179 {
180 	switch(type) {
181 	case SWITCH_MEDIA_TYPE_AUDIO:
182 		return "audio";
183 	case SWITCH_MEDIA_TYPE_VIDEO:
184 		return "video";
185 	default:
186 		return "!ERR";
187 
188 	}
189 }
190 
191 
192 SWITCH_DECLARE(switch_status_t) switch_media_handle_create(switch_media_handle_t **smhp, switch_core_session_t *session, switch_core_media_params_t *params);
193 SWITCH_DECLARE(void) switch_media_handle_destroy(switch_core_session_t *session);
194 SWITCH_DECLARE(switch_media_handle_t *) switch_core_session_get_media_handle(switch_core_session_t *session);
195 SWITCH_DECLARE(switch_status_t) switch_core_session_clear_media_handle(switch_core_session_t *session);
196 SWITCH_DECLARE(switch_status_t) switch_core_session_media_handle_ready(switch_core_session_t *session);
197 SWITCH_DECLARE(void) switch_media_handle_set_media_flag(switch_media_handle_t *smh, switch_core_media_flag_t flag);
198 SWITCH_DECLARE(void) switch_media_handle_clear_media_flag(switch_media_handle_t *smh, switch_core_media_flag_t flag);
199 SWITCH_DECLARE(int32_t) switch_media_handle_test_media_flag(switch_media_handle_t *smh, switch_core_media_flag_t flag);
200 SWITCH_DECLARE(void) switch_media_handle_set_media_flags(switch_media_handle_t *smh, switch_core_media_flag_t flags[]);
201 SWITCH_DECLARE(void) switch_core_session_check_outgoing_crypto(switch_core_session_t *session);
202 SWITCH_DECLARE(const char *) switch_core_session_local_crypto_key(switch_core_session_t *session, switch_media_type_t type);
203 SWITCH_DECLARE(int) switch_core_session_check_incoming_crypto(switch_core_session_t *session,
204 															  const char *varname,
205 															  switch_media_type_t type, const char *crypto, int crypto_tag, switch_sdp_type_t sdp_type);
206 
207 
208 SWITCH_DECLARE(uint32_t) switch_core_media_get_video_fps(switch_core_session_t *session);
209 SWITCH_DECLARE(void) switch_core_media_set_rtp_session(switch_core_session_t *session, switch_media_type_t type, switch_rtp_t *rtp_session);
210 
211 SWITCH_DECLARE(const char *)switch_core_media_get_codec_string(switch_core_session_t *session);
212 SWITCH_DECLARE(void) switch_core_media_parse_rtp_bugs(switch_rtp_bug_flag_t *flag_pole, const char *str);
213 SWITCH_DECLARE(switch_status_t) switch_core_media_add_crypto(switch_core_session_t *session, switch_secure_settings_t *ssec, switch_rtp_crypto_direction_t direction);
214 SWITCH_DECLARE(switch_t38_options_t *) switch_core_media_extract_t38_options(switch_core_session_t *session, const char *r_sdp);
215 SWITCH_DECLARE(void) switch_core_media_pass_zrtp_hash(switch_core_session_t *session);
216 SWITCH_DECLARE(const char *) switch_core_media_get_zrtp_hash(switch_core_session_t *session, switch_media_type_t type, switch_bool_t local);
217 SWITCH_DECLARE(void) switch_core_media_pass_zrtp_hash2(switch_core_session_t *aleg_session, switch_core_session_t *bleg_session);
218 SWITCH_DECLARE(int) switch_core_media_toggle_hold(switch_core_session_t *session, int sendonly);
219 SWITCH_DECLARE(void) switch_core_media_reset_t38(switch_core_session_t *session);
220 SWITCH_DECLARE(void) switch_core_media_copy_t38_options(switch_t38_options_t *t38_options, switch_core_session_t *session);
221 SWITCH_DECLARE(uint8_t) switch_core_media_negotiate_sdp(switch_core_session_t *session, const char *r_sdp, uint8_t *proceed, switch_sdp_type_t sdp_type);
222 SWITCH_DECLARE(switch_status_t) switch_core_media_set_video_codec(switch_core_session_t *session, int force);
223 SWITCH_DECLARE(switch_status_t) switch_core_media_set_codec(switch_core_session_t *session, int force, uint32_t codec_flags);
224 SWITCH_DECLARE(void) switch_core_media_check_video_codecs(switch_core_session_t *session);
225 SWITCH_DECLARE(switch_status_t) switch_core_media_read_frame(switch_core_session_t *session, switch_frame_t **frame,
226 															 switch_io_flag_t flags, int stream_id, switch_media_type_t type);
227 SWITCH_DECLARE(switch_status_t) switch_core_media_write_frame(switch_core_session_t *session,
228 															  switch_frame_t *frame, switch_io_flag_t flags, int stream_id, switch_media_type_t type);
229 SWITCH_DECLARE(int) switch_core_media_check_nat(switch_media_handle_t *smh, const char *network_ip);
230 
231 SWITCH_DECLARE(switch_status_t) switch_core_media_choose_port(switch_core_session_t *session, switch_media_type_t type, int force);
232 SWITCH_DECLARE(switch_status_t) switch_core_media_choose_ports(switch_core_session_t *session, switch_bool_t audio, switch_bool_t video);
233 SWITCH_DECLARE(void) switch_core_media_check_dtmf_type(switch_core_session_t *session);
234 SWITCH_DECLARE(void) switch_core_media_absorb_sdp(switch_core_session_t *session);
235 SWITCH_DECLARE(switch_status_t) switch_core_media_proxy_remote_addr(switch_core_session_t *session, const char *sdp_str);
236 SWITCH_DECLARE(void) switch_core_media_parse_media_flags(switch_core_session_t *session);
237 SWITCH_DECLARE(void) switch_core_media_deactivate_rtp(switch_core_session_t *session);
238 SWITCH_DECLARE(switch_status_t) switch_core_media_activate_rtp(switch_core_session_t *session);
239 SWITCH_DECLARE(switch_status_t) switch_core_media_ext_address_lookup(switch_core_session_t *session, char **ip, switch_port_t *port, const char *sourceip);
240 SWITCH_DECLARE(switch_status_t) switch_core_media_process_t38_passthru(switch_core_session_t *session,
241 																	   switch_core_session_t *other_session, switch_t38_options_t *t38_options);
242 SWITCH_DECLARE(void) switch_core_media_gen_local_sdp(switch_core_session_t *session, switch_sdp_type_t sdp_type,
243 													 const char *ip, switch_port_t port, const char *sr, int force);
244 SWITCH_DECLARE(void)switch_core_media_set_local_sdp(switch_core_session_t *session, const char *sdp_str, switch_bool_t dup);
245 SWITCH_DECLARE(void) switch_core_media_patch_sdp(switch_core_session_t *session);
246 SWITCH_DECLARE(void) switch_core_media_set_udptl_image_sdp(switch_core_session_t *session, switch_t38_options_t *t38_options, int insist);
247 SWITCH_DECLARE(switch_core_media_params_t *) switch_core_media_get_mparams(switch_media_handle_t *smh);
248 SWITCH_DECLARE(void) switch_core_media_prepare_codecs(switch_core_session_t *session, switch_bool_t force);
249 SWITCH_DECLARE(void) switch_core_media_start_udptl(switch_core_session_t *session, switch_t38_options_t *t38_options);
250 SWITCH_DECLARE(void) switch_core_media_hard_mute(switch_core_session_t *session, switch_bool_t on);
251 SWITCH_DECLARE(switch_status_t) switch_core_media_receive_message(switch_core_session_t *session, switch_core_session_message_t *msg);
252 
253 
254 
255 SWITCH_DECLARE(void) switch_core_media_break(switch_core_session_t *session, switch_media_type_t type);
256 SWITCH_DECLARE(void) switch_core_media_kill_socket(switch_core_session_t *session, switch_media_type_t type);
257 SWITCH_DECLARE(switch_status_t) switch_core_media_queue_rfc2833(switch_core_session_t *session, switch_media_type_t type, const switch_dtmf_t *dtmf);
258 SWITCH_DECLARE(switch_status_t) switch_core_media_queue_rfc2833_in(switch_core_session_t *session, switch_media_type_t type, const switch_dtmf_t *dtmf);
259 SWITCH_DECLARE(uint8_t) switch_core_media_ready(switch_core_session_t *session, switch_media_type_t type);
260 SWITCH_DECLARE(void) switch_core_media_set_telephony_event(switch_core_session_t *session, switch_media_type_t type, switch_payload_t te);
261 SWITCH_DECLARE(void) switch_core_media_set_telephony_recv_event(switch_core_session_t *session, switch_media_type_t type, switch_payload_t te);
262 SWITCH_DECLARE(switch_rtp_stats_t *) switch_core_media_stats(switch_core_session_t *session, switch_media_type_t type, switch_memory_pool_t *pool);
263 SWITCH_DECLARE(switch_status_t) switch_core_media_udptl_mode(switch_core_session_t *session, switch_media_type_t type);
264 SWITCH_DECLARE(switch_bool_t) switch_core_media_check_udptl_mode(switch_core_session_t *session, switch_media_type_t type);
265 
266 SWITCH_DECLARE(void) switch_core_media_set_rtp_flag(switch_core_session_t *session, switch_media_type_t type, switch_rtp_flag_t flag);
267 SWITCH_DECLARE(void) switch_core_media_clear_rtp_flag(switch_core_session_t *session, switch_media_type_t type, switch_rtp_flag_t flag);
268 SWITCH_DECLARE(switch_jb_t *) switch_core_media_get_jb(switch_core_session_t *session, switch_media_type_t type);
269 SWITCH_DECLARE(switch_rtp_stats_t *) switch_core_media_get_stats(switch_core_session_t *session, switch_media_type_t type, switch_memory_pool_t *pool);
270 
271 
272 SWITCH_DECLARE(void) switch_core_media_set_sdp_codec_string(switch_core_session_t *session, const char *r_sdp, switch_sdp_type_t sdp_type);
273 SWITCH_DECLARE(void) switch_core_media_merge_sdp_codec_string(switch_core_session_t *session, const char *r_sdp,
274 															  switch_sdp_type_t sdp_type, const char *codec_string);
275 
276 
277 SWITCH_DECLARE(void) switch_core_media_reset_autofix(switch_core_session_t *session, switch_media_type_t type);
278 SWITCH_DECLARE(void) switch_core_media_check_outgoing_proxy(switch_core_session_t *session, switch_core_session_t *o_session);
279 SWITCH_DECLARE(switch_status_t) switch_core_media_codec_chosen(switch_core_session_t *session, switch_media_type_t media);
280 SWITCH_DECLARE (void) switch_core_media_recover_session(switch_core_session_t *session);
281 SWITCH_DECLARE(switch_status_t) switch_core_media_add_ice_acl(switch_core_session_t *session, switch_media_type_t type, const char *acl_name);
282 SWITCH_DECLARE(void) switch_core_session_set_ice(switch_core_session_t *session);
283 SWITCH_DECLARE(void) switch_core_media_clear_ice(switch_core_session_t *session);
284 SWITCH_DECLARE(void) switch_core_media_pause(switch_core_session_t *session);
285 SWITCH_DECLARE(void) switch_core_media_resume(switch_core_session_t *session);
286 SWITCH_DECLARE(void) switch_core_media_init(void);
287 SWITCH_DECLARE(void) switch_core_media_deinit(void);
288 SWITCH_DECLARE(void) switch_core_media_set_stats(switch_core_session_t *session);
289 SWITCH_DECLARE(void) switch_core_media_sync_stats(switch_core_session_t *session);
290 SWITCH_DECLARE(void) switch_core_session_wake_video_thread(switch_core_session_t *session);
291 SWITCH_DECLARE(void) switch_core_session_clear_crypto(switch_core_session_t *session);
292 
293 SWITCH_DECLARE(switch_status_t) switch_core_session_get_payload_code(switch_core_session_t *session,
294 																	 switch_media_type_t type,
295 																	 const char *iananame,
296 																	 uint32_t rate,
297 																	 const char *fmtp_in,
298 																	 switch_payload_t *ptP,
299 																	 switch_payload_t *recv_ptP,
300 																	 char **fmtpP);
301 
302 SWITCH_DECLARE(payload_map_t *) switch_core_media_add_payload_map(switch_core_session_t *session,
303 																  switch_media_type_t type,
304 																  const char *name,
305 																  const char *modname,
306 																  const char *fmtp,
307 																  switch_sdp_type_t sdp_type,
308 																  uint32_t pt,
309 																  uint32_t rate,
310 																  uint32_t ptime,
311 																  uint32_t channels,
312 																  uint8_t negotiated);
313 
314 SWITCH_DECLARE(switch_status_t) switch_core_media_check_autoadj(switch_core_session_t *session);
315 SWITCH_DECLARE(switch_rtp_crypto_key_type_t) switch_core_media_crypto_str2type(const char *str);
316 SWITCH_DECLARE(const char *) switch_core_media_crypto_type2str(switch_rtp_crypto_key_type_t type);
317 SWITCH_DECLARE(int) switch_core_media_crypto_keysalt_len(switch_rtp_crypto_key_type_t type);
318 SWITCH_DECLARE(int) switch_core_media_crypto_salt_len(switch_rtp_crypto_key_type_t type);
319 SWITCH_DECLARE(char *) switch_core_media_filter_sdp(const char *sdp, const char *cmd, const char *arg);
320 SWITCH_DECLARE(char *) switch_core_media_process_sdp_filter(const char *sdp, const char *cmd_buf, switch_core_session_t *session);
321 
322 
323 SWITCH_DECLARE(switch_status_t) switch_core_media_codec_control(switch_core_session_t *session,
324 																switch_media_type_t mtype,
325 																switch_io_type_t iotype,
326 																switch_codec_control_command_t cmd,
327 																switch_codec_control_type_t ctype,
328 																void *cmd_data,
329 																switch_codec_control_type_t atype,
330 																void *cmd_arg,
331 																switch_codec_control_type_t *rtype,
332 																void **ret_data);
333 
334 SWITCH_DECLARE(switch_bool_t) switch_core_media_codec_get_cap(switch_core_session_t *session,
335 																switch_media_type_t mtype,
336 																switch_codec_flag_t flag);
337 
338 
339 #define switch_core_media_gen_key_frame(_session) switch_log_printf(SWITCH_CHANNEL_SESSION_LOG(_session), SWITCH_LOG_DEBUG1, "%s Send KeyFrame\n", switch_core_session_get_name(_session)); \
340 	switch_core_media_codec_control(_session, SWITCH_MEDIA_TYPE_VIDEO, SWITCH_IO_WRITE, SCC_VIDEO_GEN_KEYFRAME, SCCT_NONE, NULL, SCCT_NONE, NULL, NULL, NULL)
341 
342 #define switch_core_media_write_bandwidth(_session, _val) switch_core_media_codec_control(_session, SWITCH_MEDIA_TYPE_VIDEO, SWITCH_IO_WRITE, \
343 																						  SCC_VIDEO_BANDWIDTH, SCCT_STRING, _val, SCCT_NONE, NULL, NULL, NULL)
344 
345 
346 SWITCH_DECLARE(switch_timer_t *) switch_core_media_get_timer(switch_core_session_t *session, switch_media_type_t mtype);
347 SWITCH_DECLARE(void) switch_core_media_start_engine_function(switch_core_session_t *session, switch_media_type_t type, switch_engine_function_t engine_function, void *user_data);
348 SWITCH_DECLARE(void) switch_core_media_end_engine_function(switch_core_session_t *session, switch_media_type_t type);
349 SWITCH_DECLARE(switch_status_t) switch_core_session_start_video_thread(switch_core_session_t *session);
350 SWITCH_DECLARE(int) switch_core_media_check_engine_function(switch_core_session_t *session, switch_media_type_t type);
351 SWITCH_DECLARE(void) switch_core_session_video_reinit(switch_core_session_t *session);
352 SWITCH_DECLARE(switch_status_t) switch_core_media_read_lock_unlock(switch_core_session_t *session, switch_media_type_t type, switch_bool_t lock);
353 
354 #define switch_core_media_read_lock(_s, _t) switch_core_media_read_lock_unlock(_s, _t, SWITCH_TRUE)
355 #define switch_core_media_read_unlock(_s, _t) switch_core_media_read_lock_unlock(_s, _t, SWITCH_FALSE)
356 
357 SWITCH_DECLARE(void) switch_core_session_stop_media(switch_core_session_t *session);
358 SWITCH_DECLARE(switch_media_flow_t) switch_core_session_media_flow(switch_core_session_t *session, switch_media_type_t type);
359 SWITCH_DECLARE(switch_status_t) switch_core_media_get_vid_params(switch_core_session_t *session, switch_vid_params_t *vid_params);
360 SWITCH_DECLARE(void) switch_core_session_write_blank_video(switch_core_session_t *session, uint32_t ms);
361 SWITCH_DECLARE(switch_status_t) switch_core_media_lock_video_file(switch_core_session_t *session, switch_rw_t rw);
362 SWITCH_DECLARE(switch_status_t) switch_core_media_unlock_video_file(switch_core_session_t *session, switch_rw_t rw);
363 SWITCH_DECLARE(switch_status_t) switch_core_media_set_video_file(switch_core_session_t *session, switch_file_handle_t *fh, switch_rw_t rw);
364 SWITCH_DECLARE(switch_file_handle_t *) switch_core_media_get_video_file(switch_core_session_t *session, switch_rw_t rw);
365 SWITCH_DECLARE(switch_bool_t) switch_core_session_in_video_thread(switch_core_session_t *session);
366 SWITCH_DECLARE(switch_bool_t) switch_core_media_check_dtls(switch_core_session_t *session, switch_media_type_t type);
367 SWITCH_DECLARE(switch_status_t) switch_core_media_set_outgoing_bitrate(switch_core_session_t *session, switch_media_type_t type, uint32_t bitrate);
368 SWITCH_DECLARE(uint32_t) switch_core_media_get_orig_bitrate(switch_core_session_t *session, switch_media_type_t type);
369 SWITCH_DECLARE(void) switch_core_media_set_media_bw_mult(switch_core_session_t *session, float mult);
370 SWITCH_DECLARE(float) switch_core_media_get_media_bw_mult(switch_core_session_t *session);
371 SWITCH_DECLARE(switch_status_t) switch_core_media_reset_jb(switch_core_session_t *session, switch_media_type_t type);
372 SWITCH_DECLARE(switch_status_t) switch_core_session_wait_for_video_input_params(switch_core_session_t *session, uint32_t timeout_ms);
373 
374 
375 SWITCH_DECLARE(switch_status_t) switch_core_session_set_text_read_callback(switch_core_session_t *session,
376 																		   switch_core_text_thread_callback_func_t func, void *user_data);
377 SWITCH_DECLARE(switch_status_t) switch_core_session_text_read_callback(switch_core_session_t *session, switch_frame_t *frame);
378 SWITCH_DECLARE(switch_status_t) switch_core_session_read_text_frame(switch_core_session_t *session, switch_frame_t **frame, switch_io_flag_t flags,
379 																	int stream_id);
380 
381 SWITCH_DECLARE(switch_status_t) switch_core_session_write_text_frame(switch_core_session_t *session, switch_frame_t *frame, switch_io_flag_t flags,
382 																	 int stream_id);
383 
384 SWITCH_DECLARE(switch_status_t) switch_rtp_text_factory_create(switch_rtp_text_factory_t **tfP, switch_memory_pool_t *pool);
385 SWITCH_DECLARE(switch_status_t) switch_rtp_text_factory_destroy(switch_rtp_text_factory_t **tfP);
386 
387 SWITCH_DECLARE(switch_status_t) switch_core_session_print(switch_core_session_t *session, const char *data);
388 SWITCH_DECLARE(switch_status_t) switch_core_session_printf(switch_core_session_t *session, const char *fmt, ...);
389 
390 SWITCH_DECLARE(switch_msrp_session_t *) switch_core_media_get_msrp_session(switch_core_session_t *session);
391 SWITCH_DECLARE(void) switch_core_media_set_smode(switch_core_session_t *session, switch_media_type_t type, switch_media_flow_t smode, switch_sdp_type_t sdp_type);
392 
393 SWITCH_END_EXTERN_C
394 #endif
395 /* For Emacs:
396  * Local Variables:
397  * mode:c
398  * indent-tabs-mode:t
399  * tab-width:4
400  * c-basic-offset:4
401  * End:
402  * For VIM:
403  * vim:set softtabstop=4 shiftwidth=4 tabstop=4 noet:
404  */
405 
406