fixed a use count bug
[asterisk/asterisk.git] / include / asterisk / rtp.h
1 /*
2  * Asterisk -- A telephony toolkit for Linux.
3  *
4  * Real-time Transport Protocol support
5  * 
6  * Copyright (C) 1999, Mark Spencer
7  *
8  * Mark Spencer <markster@linux-support.net>
9  *
10  * This program is free software, distributed under the terms of
11  * the GNU General Public License
12  */
13
14 #ifndef _ASTERISK_RTP_H
15 #define _ASTERISK_RTP_H
16
17 #include <asterisk/frame.h>
18 #include <asterisk/io.h>
19 #include <asterisk/sched.h>
20 #include <asterisk/channel.h>
21
22 #include <netinet/in.h>
23
24 #if defined(__cplusplus) || defined(c_plusplus)
25 extern "C" {
26 #endif
27
28 /* Codes for RTP-specific data - not defined by our AST_FORMAT codes */
29 /*! DTMF (RFC2833) */
30 #define AST_RTP_DTMF            (1 << 0)
31 /*! 'Comfort Noise' (RFC3389) */
32 #define AST_RTP_CN              (1 << 1)
33 /*! DTMF (Cisco Proprietary) */
34 #define AST_RTP_CISCO_DTMF      (1 << 2)
35 /*! Maximum RTP-specific code */
36 #define AST_RTP_MAX             AST_RTP_CISCO_DTMF
37
38 struct ast_rtp_protocol {
39         struct ast_rtp *(*get_rtp_info)(struct ast_channel *chan);                              /* Get RTP struct, or NULL if unwilling to transfer */
40         struct ast_rtp *(*get_vrtp_info)(struct ast_channel *chan);                             /* Get RTP struct, or NULL if unwilling to transfer */
41         int (*set_rtp_peer)(struct ast_channel *chan, struct ast_rtp *peer, struct ast_rtp *vpeer, int codecs); /* Set RTP peer */
42         int (*get_codec)(struct ast_channel *chan);
43         char *type;
44         struct ast_rtp_protocol *next;
45 };
46
47 struct ast_rtp;
48
49 typedef int (*ast_rtp_callback)(struct ast_rtp *rtp, struct ast_frame *f, void *data);
50
51 struct ast_rtp *ast_rtp_new(struct sched_context *sched, struct io_context *io, int rtcpenable, int callbackmode);
52
53 struct ast_rtp *ast_rtp_new_with_bindaddr(struct sched_context *sched, struct io_context *io, int rtcpenable, int callbackmode, struct in_addr in);
54
55 void ast_rtp_set_peer(struct ast_rtp *rtp, struct sockaddr_in *them);
56
57 void ast_rtp_get_peer(struct ast_rtp *rtp, struct sockaddr_in *them);
58
59 void ast_rtp_get_us(struct ast_rtp *rtp, struct sockaddr_in *us);
60
61 void ast_rtp_destroy(struct ast_rtp *rtp);
62
63 void ast_rtp_set_callback(struct ast_rtp *rtp, ast_rtp_callback callback);
64
65 void ast_rtp_set_data(struct ast_rtp *rtp, void *data);
66
67 int ast_rtp_write(struct ast_rtp *rtp, struct ast_frame *f);
68
69 struct ast_frame *ast_rtp_read(struct ast_rtp *rtp);
70
71 struct ast_frame *ast_rtcp_read(struct ast_rtp *rtp);
72
73 int ast_rtp_fd(struct ast_rtp *rtp);
74
75 int ast_rtcp_fd(struct ast_rtp *rtp);
76
77 int ast_rtp_senddigit(struct ast_rtp *rtp, char digit);
78
79 int ast_rtp_settos(struct ast_rtp *rtp, int tos);
80
81 // Setting RTP payload types from lines in a SDP description:
82 void ast_rtp_pt_clear(struct ast_rtp* rtp);
83 /* Set payload types to defaults */
84 void ast_rtp_pt_default(struct ast_rtp* rtp);
85 void ast_rtp_set_m_type(struct ast_rtp* rtp, int pt);
86 void ast_rtp_set_rtpmap_type(struct ast_rtp* rtp, int pt,
87                          char* mimeType, char* mimeSubtype);
88
89 // Mapping between RTP payload format codes and Asterisk codes:
90 struct rtpPayloadType ast_rtp_lookup_pt(struct ast_rtp* rtp, int pt);
91 int ast_rtp_lookup_code(struct ast_rtp* rtp, int isAstFormat, int code);
92
93 void ast_rtp_get_current_formats(struct ast_rtp* rtp,
94                              int* astFormats, int* nonAstFormats);
95
96 // Mapping an Asterisk code into a MIME subtype (string):
97 char* ast_rtp_lookup_mime_subtype(int isAstFormat, int code);
98
99 void ast_rtp_setnat(struct ast_rtp *rtp, int nat);
100
101 int ast_rtp_bridge(struct ast_channel *c0, struct ast_channel *c1, int flags, struct ast_frame **fo, struct ast_channel **rc);
102
103 int ast_rtp_proto_register(struct ast_rtp_protocol *proto);
104
105 void ast_rtp_proto_unregister(struct ast_rtp_protocol *proto);
106
107 void ast_rtp_stop(struct ast_rtp *rtp);
108
109 void ast_rtp_init(void);
110
111 void ast_rtp_reload(void);
112
113 #if defined(__cplusplus) || defined(c_plusplus)
114 }
115 #endif
116
117 #endif