0ac7f96057
This fixes a class of issues where Stasis applications were not made aware that their channels were being manipulated or replaced by external entitiessuch as transfers, AMI commands, or dialplan applications such as Bridge(). Inconsistent information such as StasisEnd events with unknown channels as a result of masquerades has also been corrected. To accomplish these fixes, several new fields were added to blind and attended transfer messages as well as StasisStart and BridgeAttendedTransfer Stasis events. ASTERISK-23941 #close Review: https://reviewboard.asterisk.org/r/3865/ Review: https://reviewboard.asterisk.org/r/3857/ Review: https://reviewboard.asterisk.org/r/3852/ Review: https://reviewboard.asterisk.org/r/3816/ Review: https://reviewboard.asterisk.org/r/3731/ Review: https://reviewboard.asterisk.org/r/3729/ Review: https://reviewboard.asterisk.org/r/3728/ ........ Merged revisions 420325 from http://svn.asterisk.org/svn/asterisk/branches/12 git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@420338 65c4cc65-6c06-0410-ace0-fbb531ad65f3
113 lines
3.1 KiB
C
113 lines
3.1 KiB
C
/*
|
|
* Asterisk -- An open source telephony toolkit.
|
|
*
|
|
* Copyright (C) 2013, Digium, Inc.
|
|
*
|
|
* David M. Lee, II <dlee@digium.com>
|
|
*
|
|
* See http://www.asterisk.org for more information about
|
|
* the Asterisk project. Please do not directly contact
|
|
* any of the maintainers of this project for assistance;
|
|
* the project provides a web site, mailing lists and IRC
|
|
* channels for your use.
|
|
*
|
|
* This program is free software, distributed under the terms of
|
|
* the GNU General Public License Version 2. See the LICENSE file
|
|
* at the top of the source tree.
|
|
*/
|
|
|
|
#ifndef _ASTERISK_RES_STASIS_CONTROL_H
|
|
#define _ASTERISK_RES_STASIS_CONTROL_H
|
|
|
|
/*! \file
|
|
*
|
|
* \brief Internal API for the Stasis application controller.
|
|
*
|
|
* \author David M. Lee, II <dlee@digium.com>
|
|
* \since 12
|
|
*/
|
|
|
|
#include "asterisk/stasis_app.h"
|
|
|
|
/*!
|
|
* \brief Create a control object.
|
|
*
|
|
* \param channel Channel to control.
|
|
* \param app stasis_app for which this control is being created.
|
|
*
|
|
* \return New control object.
|
|
* \return \c NULL on error.
|
|
*/
|
|
struct stasis_app_control *control_create(struct ast_channel *channel, struct stasis_app *app);
|
|
|
|
/*!
|
|
* \brief Dispatch all commands enqueued to this control.
|
|
*
|
|
* \param control Control object to dispatch.
|
|
* \param chan Associated channel.
|
|
* \return Number of commands executed
|
|
*/
|
|
int control_dispatch_all(struct stasis_app_control *control,
|
|
struct ast_channel *chan);
|
|
|
|
/*!
|
|
* \brief Blocks until \a control's command queue has a command available.
|
|
*
|
|
* \param control Control to block on.
|
|
*/
|
|
void control_wait(struct stasis_app_control *control);
|
|
|
|
/*!
|
|
* \brief Returns the count of items in a control's command queue.
|
|
*
|
|
* \param control Control to count commands on
|
|
*
|
|
* \retval number of commands in the command que
|
|
*/
|
|
int control_command_count(struct stasis_app_control *control);
|
|
|
|
/*!
|
|
* \brief Returns true if control_continue() has been called on this \a control.
|
|
*
|
|
* \param control Control to query.
|
|
* \return True (non-zero) if control_continue() has been called.
|
|
* \return False (zero) otherwise.
|
|
*/
|
|
int control_is_done(struct stasis_app_control *control);
|
|
|
|
void control_mark_done(struct stasis_app_control *control);
|
|
|
|
/*!
|
|
* \brief Dispatch all queued prestart commands
|
|
*
|
|
* \param control The control for chan
|
|
* \param channel The channel on which commands should be executed
|
|
*
|
|
* \return The number of commands executed
|
|
*/
|
|
int control_prestart_dispatch_all(struct stasis_app_control *control,
|
|
struct ast_channel *chan);
|
|
|
|
/*!
|
|
* \brief Returns the pointer (non-reffed) to the app associated with this control
|
|
*
|
|
* \param control Control to query.
|
|
*
|
|
* \returns A pointer to the associated stasis_app
|
|
*/
|
|
struct stasis_app *control_app(struct stasis_app_control *control);
|
|
|
|
/*!
|
|
* \brief Command callback for adding a channel to a bridge
|
|
*
|
|
* \param control The control for chan
|
|
* \param channel The channel on which commands should be executed
|
|
* \param bridge Data to be passed to the callback
|
|
*/
|
|
int control_add_channel_to_bridge(
|
|
struct stasis_app_control *control,
|
|
struct ast_channel *chan, void *obj);
|
|
|
|
|
|
#endif /* _ASTERISK_RES_STASIS_CONTROL_H */
|