/* -*- 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 #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__*/