mirror of
https://github.com/asterisk/asterisk.git
synced 2026-06-04 10:22:01 +00:00
48864ab877
ast_walk_indications(), to walk through the list of indications. The new method returns an unlocked record, which is no different from the behaviour of other existing methods in indications.c (i.e. they all need to be fixed, with refcounts or some similar method). Note that ast_walk_indications() uses the pointer argument only as a search key, so its implementation is completely safe. In turn, this change allows the removal of AST_MUTEX_DEFINE_EXPORTED. git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@16532 65c4cc65-6c06-0410-ace0-fbb531ad65f3
93 lines
3.6 KiB
C
93 lines
3.6 KiB
C
/*
|
|
* Asterisk -- An open source telephony toolkit.
|
|
*
|
|
* 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.
|
|
*/
|
|
|
|
/*! \file
|
|
* \brief BSD Telephony Of Mexico "Tormenta" Tone Zone Support 2/22/01
|
|
*
|
|
* This program 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 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* This program 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 General Public License
|
|
* along with this program; if not, write to the Free Software
|
|
* Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
|
|
*
|
|
* Primary Author: Pauline Middelink <middelink@polyware.nl>
|
|
*
|
|
*/
|
|
|
|
#ifndef _ASTERISK_INDICATIONS_H
|
|
#define _ASTERISK_INDICATIONS_H
|
|
|
|
#include "asterisk/lock.h"
|
|
|
|
/* forward reference */
|
|
struct ast_channel;
|
|
|
|
struct tone_zone_sound {
|
|
struct tone_zone_sound *next; /* next element */
|
|
const char *name; /* Identifing name */
|
|
const char *data; /* Actual zone description */
|
|
/* Description is a series of tones of the format:
|
|
[!]freq1[+freq2][/duration] separated by commas. There
|
|
are no spaces. The sequence is repeated back to the
|
|
first tone description not preceeded by !. Duration is
|
|
specified in milliseconds */
|
|
};
|
|
|
|
struct tone_zone {
|
|
struct tone_zone* next; /* next in list */
|
|
char country[5]; /* Country code */
|
|
char alias[5]; /* is this an alias? */
|
|
char description[40]; /* Description */
|
|
int nrringcadence; /* # registered ringcadence elements */
|
|
int *ringcadence; /* Ring cadence */
|
|
struct tone_zone_sound *tones; /* The known tones for this zone */
|
|
};
|
|
|
|
/* set the default tone country */
|
|
int ast_set_indication_country(const char *country);
|
|
|
|
/* locate tone_zone, given the country. if country == NULL, use the default country */
|
|
struct tone_zone *ast_get_indication_zone(const char *country);
|
|
/* locate a tone_zone_sound, given the tone_zone. if tone_zone == NULL, use the default tone_zone */
|
|
struct tone_zone_sound *ast_get_indication_tone(const struct tone_zone *zone, const char *indication);
|
|
|
|
/* add a new country, if country exists, it will be replaced. */
|
|
int ast_register_indication_country(struct tone_zone *country);
|
|
/* remove an existing country and all its indications, country must exist */
|
|
int ast_unregister_indication_country(const char *country);
|
|
/* add a new indication to a tone_zone. tone_zone must exist. if the indication already
|
|
* exists, it will be replaced. */
|
|
int ast_register_indication(struct tone_zone *zone, const char *indication, const char *tonelist);
|
|
/* remove an existing tone_zone's indication. tone_zone must exist */
|
|
int ast_unregister_indication(struct tone_zone *zone, const char *indication);
|
|
|
|
/* Start a tone-list going */
|
|
int ast_playtones_start(struct ast_channel *chan, int vol, const char* tonelist, int interruptible);
|
|
/*! Stop the tones from playing */
|
|
void ast_playtones_stop(struct ast_channel *chan);
|
|
|
|
/* support for walking through a list of indications */
|
|
struct tone_zone *ast_walk_indications(const struct tone_zone *cur);
|
|
|
|
#if 0
|
|
extern struct tone_zone *tone_zones;
|
|
extern ast_mutex_t tzlock;
|
|
#endif
|
|
|
|
#endif /* _ASTERISK_INDICATIONS_H */
|