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
|
/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
/* vim: set et sw=2 ts=2: */
/***************************************************************************
* lrtp.h
*
* Mon Sep 2 12:10:40 CEST 2013
* Copyright 2013 Bent Bisballe Nyeng
* deva@aasimon.org
****************************************************************************/
/*
* This file is part of lrtp.
*
* lrtp is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* lrtp 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
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with lrtp; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
*/
#ifndef __LRTP_LRTP_H__
#define __LRTP_LRTP_H__
#ifdef WIN32
#ifdef BUILD_DLL
/* DLL export */
#define EXPORT __declspec(dllexport)
#else
/* EXE import */
#define EXPORT __declspec(dllimport)
#endif
#else
#define EXPORT
#endif
#ifdef __cplusplus
extern "C" {
#endif
#include <stdlib.h>
#include "lrtp_profiles.h"
struct lrtp_t;
EXPORT
struct lrtp_t *lrtp_init(const char *key, unsigned int ssrc);
EXPORT
void lrtp_close(struct lrtp_t *lrtp);
/**
* @return 0 on success, 1 on error.
*/
EXPORT
int lrtp_create_profile(struct lrtp_t *lrtp,
lrtp_profile_id_t profile_id,
unsigned int csrc, ...);
EXPORT
void lrtp_destroy_profile(struct lrtp_t *lrtp, unsigned int csrc);
typedef enum {
// Errors:
PACK_ERROR = 1000, // Error...
PACK_BUFFER_TOO_SMALL = 1001, // Packet buffer needs to be bigger.
PACK_UNKNOWN_PROFILE = 1002, // Illegal profile id
PACK_MISSING_PROFILE = 1003, // Profile pointer NULL or not valid.
} lrtp_pack_status_t;
/**
* Enqueue a media frame for the packetiser.
* @param profile A pointer to profile needed for processing the frame type.
* @param framedate The frame data that needs encapsulation.
* @param framesize The size in bytes of the frame data.
* @return 0 on success, or a negative error code on error.
* WARNING: The frame pointer cannot be freed or overwritten until all frame
* data has been handled by lrtp_pack(). Either call lrtp_pack() until it
* returns 0 after each call to lrtp_enqueue_frame or use the
* OPTION_SET_PROCESS_FINISHED_HANDLER option to set a process finished handler.
* See lrtp_profiles.h for further details.
*/
EXPORT
int lrtp_enqueue_frame(struct lrtp_t *lrtp, unsigned int csrc,
char *framedate, size_t framesize,
unsigned long int timestamp);
/**
* Handle frame data from the frame queue and create at most a single sRTP
* packet.
* @param lrtp The lrtp context handle.
* @param packet A char buffer which will contain the resulting RTP data.
* @param maxsize the maximum number of bytes that can be contained within
* packet.
* @return Returns the number of bytes written in packet, if any (can be zero
* if no packet is available) or a negative error code on error.
*/
EXPORT int lrtp_pack(struct lrtp_t *lrtp, char *packet, size_t maxsize);
typedef enum {
// Errors:
UNPACK_ERROR = 1000, // Error...
UNPACK_BUFFER_TOO_SMALL = 1001, // Frame buffer needs to be bigger.
UNPACK_MISSING_HANDLE = 1002, // Handle pointer NULL or not valid.
UNPACK_MISSING_CSRC = 1003, // Exactly one csrc must be present.
UNPACK_TOO_MANY_CSRCS = 1004, // Exactly one csrc must be present.
UNPACK_MISSING_PROFILE = 1005, // CSrc from packet could not be connected with a preofile..
} lrtp_unpack_status_t;
/**
*/
EXPORT
int lrtp_dequeue_frame(struct lrtp_t *lrtp,
char *frame, size_t maxsize,
unsigned int *csrc, unsigned int *ts);
/**
*/
EXPORT
int lrtp_unpack(struct lrtp_t *lrtp, const char *packet, size_t size);
#ifdef __cplusplus
}
#endif
#endif/*__LRTP_LRTP_H__*/
|
