mirror of
https://github.com/asterisk/asterisk.git
synced 2025-09-21 20:56:39 +00:00
9530310954
Many architectural and functional changes. Main changes are threading model chanes (many thread in ooh323 stack instead of one), modifications and improvements in signalling part, additional codecs support (726, speex), t38 mode support. This module tested and used in production environment. (closes issue #15285) Reported by: may213 Tested by: sles, c0w, OrNix Review: https://reviewboard.asterisk.org/r/324/ git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@227898 65c4cc65-6c06-0410-ace0-fbb531ad65f3
220 lines
6.8 KiB
C
220 lines
6.8 KiB
C
/*
|
|
* Copyright (C) 2004-2005 by Objective Systems, Inc.
|
|
*
|
|
* This software is furnished under an open source license and may be
|
|
* used and copied only in accordance with the terms of this license.
|
|
* The text of the license may generally be found in the root
|
|
* directory of this installation in the COPYING file. It
|
|
* can also be viewed online at the following URL:
|
|
*
|
|
* http://www.obj-sys.com/open/license.html
|
|
*
|
|
* Any redistributions of this file including modified versions must
|
|
* maintain this copyright notice.
|
|
*
|
|
*****************************************************************************/
|
|
|
|
/**
|
|
* @file oochannels.h
|
|
* This file contains functions to create and use channels.
|
|
*/
|
|
#ifndef _OOCHANNELS_H_
|
|
#define _OOCHANNELS_H_
|
|
|
|
#include "H323-MESSAGES.h"
|
|
#include "MULTIMEDIA-SYSTEM-CONTROL.h"
|
|
#include "ootypes.h"
|
|
#include "ooSocket.h"
|
|
#include "ooCalls.h"
|
|
|
|
#define OORECEIVER 1
|
|
#define OOTRANSMITTER 2
|
|
#define OODUPLEX 3
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#ifndef EXTERN
|
|
#ifdef MAKE_DLL
|
|
#define EXTERN __declspec(dllexport)
|
|
#else
|
|
#define EXTERN
|
|
#endif /* MAKE_DLL */
|
|
#endif /* EXTERN */
|
|
|
|
struct OOH323CallData;
|
|
struct Q931Message;
|
|
|
|
/**
|
|
* @defgroup channels Channel Management
|
|
* @{
|
|
*/
|
|
/**
|
|
* This function is used to create a listener for incoming calls.
|
|
*
|
|
* @return OO_OK, on success. OO_FAILED, on failure.
|
|
*/
|
|
EXTERN int ooCreateH323Listener(void);
|
|
|
|
/**
|
|
* This function is used to create a listener for incoming H.245 connections.
|
|
* @param call Pointer to call for which H.245 listener has to be created
|
|
*
|
|
* @return OO_OK, on success. OO_FAILED, on failure.
|
|
*/
|
|
EXTERN int ooCreateH245Listener(struct OOH323CallData *call);
|
|
|
|
/**
|
|
* This function is used to close an H245 listener for a call.
|
|
* @param call Pointer to call for which H245 Listener has to be closed.
|
|
*
|
|
* @return OO_OK, on success. OO_FAILED, on failure.
|
|
*/
|
|
EXTERN int ooCloseH245Listener(struct OOH323CallData *call);
|
|
|
|
/**
|
|
* This function is used to accept incoming H.225 connections.
|
|
*
|
|
* @return OO_OK, on success. OO_FAILED, on failure.
|
|
*/
|
|
EXTERN int ooAcceptH225Connection(void);
|
|
|
|
/**
|
|
* This function is used to accept an incoming H.245 connection.
|
|
* @param call Pointer to a call for which H.245 connection request has
|
|
* arrived.
|
|
*
|
|
* @return OO_OK, on succes. OO_FAILED, on failure.
|
|
*/
|
|
EXTERN int ooAcceptH245Connection(struct OOH323CallData *call);
|
|
|
|
/**
|
|
* This function is used to create an H.225 connection to the remote end point.
|
|
* @param call Pointer to the call for which H.225 connection has to be
|
|
* setup.
|
|
* @return OO_OK, on succes. OO_FAILED, on failure.
|
|
*/
|
|
EXTERN int ooCreateH225Connection(struct OOH323CallData *call);
|
|
|
|
/**
|
|
* This function is used to setup an H.245 connection with the remote endpoint
|
|
* for control negotiations.
|
|
* @param call Pointer to call for which H.245 connection has to be setup.
|
|
*
|
|
* @return OO_OK, on success. OO_FAILED, on failure.
|
|
*/
|
|
EXTERN int ooCreateH245Connection(struct OOH323CallData *call);
|
|
|
|
/**
|
|
* This function is used to close an H.225 connection
|
|
* @param call Pointer to the call for which H.225 connection has to be
|
|
* closed.
|
|
*
|
|
* @return OO_OK, on success. OO_FAILED, on failure.
|
|
*/
|
|
EXTERN int ooCloseH225Connection(struct OOH323CallData *call);
|
|
|
|
/**
|
|
* This function is used to close an H.245 connection for a call.
|
|
*
|
|
* @param call Pointer to call for which H.245 connection has
|
|
* to be closed.
|
|
* @return OO_OK, on success. OO_FAILED, on failure.
|
|
*/
|
|
EXTERN int ooCloseH245Connection(struct OOH323CallData *call);
|
|
|
|
/**
|
|
* This function is used to start monitoring channels for the calls. It has
|
|
* an infinite loop which uses select to monitor various channels.
|
|
*
|
|
*/
|
|
EXTERN int ooMonitorChannels(void);
|
|
EXTERN int ooMonitorCmdChannels(void);
|
|
EXTERN int ooMonitorCallChannels(OOH323CallData *);
|
|
|
|
/**
|
|
* This function is called to stop the monitor channels event loop.
|
|
* It cleans up all the active calls before stopping the monitor.
|
|
*
|
|
* @return OO_OK, on success. OO_FAILED, on failure
|
|
*/
|
|
EXTERN int ooStopMonitorCalls(void);
|
|
EXTERN void ooStopMonitorCallChannels(OOH323CallData *);
|
|
|
|
/**
|
|
* This function is used to receive an H.2250 message received on a calls
|
|
* H.225 channel. It receives the message, decodes it and calls
|
|
* 'ooHandleH2250Message' to process the message.
|
|
* @param call Pointer to the call for which the message has to be
|
|
* received.
|
|
*
|
|
* @return OO_OK, on success. OO_FAILED, on failure.
|
|
*/
|
|
EXTERN int ooH2250Receive(struct OOH323CallData *call);
|
|
|
|
/**
|
|
* This function is used to receive an H.245 message received on a calls
|
|
* H.245 channel. It receives the message, decodes it and calls
|
|
* 'ooHandleH245Message' to process it.
|
|
* @param call Pointer to the call for which the message has to be
|
|
* received.
|
|
*
|
|
* @return OO_OK, on success. OO_FAILED, on failure.
|
|
*/
|
|
EXTERN int ooH245Receive(struct OOH323CallData *call);
|
|
|
|
/**
|
|
* This function is used to enqueue an H.225 message into an outgoing queue for
|
|
* the call.
|
|
* @param call Pointer to call for which message has to be enqueued.
|
|
* @param msg Pointer to the H.225 message to be sent.
|
|
*
|
|
* @return OO_OK, on success. OO_FAILED, on failure.
|
|
*/
|
|
EXTERN int ooSendH225Msg(struct OOH323CallData *call, struct Q931Message *msg);
|
|
|
|
/**
|
|
* This function is used to Send a message on the channel, when channel is
|
|
* available for write.
|
|
* @param call Pointer to call for which message has to be sent.
|
|
* @param type Type of the message.
|
|
*
|
|
* @return OO_OK, on success. OO_FAILED, on failure.
|
|
*/
|
|
EXTERN int ooSendMsg(struct OOH323CallData *call, int type);
|
|
|
|
/**
|
|
* This function is called after a message is sent on the call's channel.
|
|
* It can be used to some followup action after message has been sent.
|
|
* @param call Pointer to call for which message has been sent.
|
|
* @param msgType Type of message
|
|
* @param tunneledMsgType If this message is carrying a tunneled message, then
|
|
* type of the tunneled message.
|
|
* @param associatedChan The channel number associated with the message sent,
|
|
* or tunneled message. 0, if no channel is associated.
|
|
*
|
|
* @return OO_OK, on success. OO_FAILED, on failure
|
|
*/
|
|
EXTERN int ooOnSendMsg
|
|
(struct OOH323CallData *call, int msgType, int tunneledMsgType,
|
|
int associatedChan);
|
|
|
|
/**
|
|
* This function is used to check the status of tcp connection.
|
|
* @param call Handle to the call to which connection belongs.
|
|
* @param sock Connected socket.
|
|
*
|
|
* @return True if connection is ok, false otherwise.
|
|
*/
|
|
EXTERN OOBOOL ooChannelsIsConnectionOK(OOH323CallData *call, OOSOCKET sock);
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
#endif
|
|
|