include/asterisk/features.h

   1 /*
   2  * Asterisk -- An open source telephony toolkit.
   3  *
   4  * Copyright (C) 1999 - 2005, Digium, Inc.
   5  *
   6  * Mark Spencer <markster@digium.com>
   7  *
   8  * See http://www.asterisk.org for more information about
   9  * the Asterisk project. Please do not directly contact
  10  * any of the maintainers of this project for assistance;
  11  * the project provides a web site, mailing lists and IRC
  12  * channels for your use.
  13  *
  14  * This program is free software, distributed under the terms of
  15  * the GNU General Public License Version 2. See the LICENSE file
  16  * at the top of the source tree.
  17  */
  18
  19 /*
  20  * Call Parking and Pickup API
  21  * Includes code and algorithms from the Zapata library.
  22  */
  23
  24 #ifndef _AST_FEATURES_H
  25 #define _AST_FEATURES_H
  26
  27 #define FEATURE_MAX_LEN         11
  28 #define FEATURE_APP_LEN         64
  29 #define FEATURE_APP_ARGS_LEN    256
  30 #define FEATURE_SNAME_LEN       32
  31 #define FEATURE_EXTEN_LEN       32
  32
  33 /* main call feature structure */
  34 struct ast_call_feature {
  35         int feature_mask;
  36         char *fname;
  37         char sname[FEATURE_SNAME_LEN];
  38         char exten[FEATURE_MAX_LEN];
  39         char default_exten[FEATURE_MAX_LEN];
  40         int (*operation)(struct ast_channel *chan, struct ast_channel *peer, struct ast_bridge_config *config, char *code, int sense);
  41         unsigned int flags;
  42         char app[FEATURE_APP_LEN];
  43         char app_args[FEATURE_APP_ARGS_LEN];
  44         AST_LIST_ENTRY(ast_call_feature) feature_entry;
  45 };
  46
  47
  48
  49 /*! Park a call and read back parked location */
  50 /*! \param chan the channel to actually be parked
  51     \param host the channel which will have the parked location read to
  52         Park the channel chan, and read back the parked location to the
  53         host.  If the call is not picked up within a specified period of
  54         time, then the call will return to the last step that it was in
  55         (in terms of exten, priority and context)
  56         \param timeout is a timeout in milliseconds
  57         \param extout is a parameter to an int that will hold the parked location, or NULL if you want
  58 */
  59 extern int ast_park_call(struct ast_channel *chan, struct ast_channel *host, int timeout, int *extout);
  60 /*! Park a call via a masqueraded channel */
  61 /*! \param rchan the real channel to be parked
  62     \param host the channel to have the parking read to
  63         Masquerade the channel rchan into a new, empty channel which is then
  64         parked with ast_park_call
  65         \param timeout is a timeout in milliseconds
  66         \param extout is a parameter to an int that will hold the parked location, or NULL if you want
  67 */
  68 extern int ast_masq_park_call(struct ast_channel *rchan, struct ast_channel *host, int timeout, int *extout);
  69
  70 /*! Determine system parking extension */
  71 /*! Returns the call parking extension for drivers that provide special
  72     call parking help */
  73 extern char *ast_parking_ext(void);
  74 extern char *ast_pickup_ext(void);
  75
  76 /*! Bridge a call, optionally allowing redirection */
  77
  78 extern int ast_bridge_call(struct ast_channel *chan, struct ast_channel *peer,struct ast_bridge_config *config);
  79
  80 extern int ast_pickup_call(struct ast_channel *chan);
  81
  82 /*! register new feature into feature_set
  83    \param feature an ast_call_feature object which contains a keysequence
  84    and a callback function which is called when this keysequence is pressed
  85    during a call. */
  86 extern void ast_register_feature(struct ast_call_feature *feature);
  87
  88 /*! unregister feature from feature_set
  89     \param feature the ast_call_feature object which was registered before*/
  90 extern void ast_unregister_feature(struct ast_call_feature *feature);
  91
  92 #endif /* _AST_FEATURES_H */