Sat Mar 10 01:55:31 2012

Asterisk developer's documentation


mod_format.h File Reference

Header for providers of file and format handling routines. Clients of these routines should include "asterisk/file.h" instead. More...

#include "asterisk/file.h"
#include "asterisk/frame.h"

Go to the source code of this file.

Data Structures

struct  ast_filestream
 This structure is allocated by file.c in one chunk, together with buf_size and desc_size bytes of memory to be used for private purposes (e.g. buffers etc.). More...
struct  ast_format
 Each supported file format is described by the following structure. More...

Defines

#define ast_format_register(f)   __ast_format_register(f, ast_module_info->self)

Functions

int __ast_format_register (const struct ast_format *f, struct ast_module *mod)
 Register a new file format capability. Adds a format to Asterisk's format abilities.
int ast_format_unregister (const char *name)
 Unregisters a file format.


Detailed Description

Header for providers of file and format handling routines. Clients of these routines should include "asterisk/file.h" instead.

Definition in file mod_format.h.


Define Documentation

#define ast_format_register ( f   )     __ast_format_register(f, ast_module_info->self)

Definition at line 131 of file mod_format.h.

Referenced by load_module().


Function Documentation

int __ast_format_register ( const struct ast_format f,
struct ast_module mod 
)

Register a new file format capability. Adds a format to Asterisk's format abilities.

Return values:
0 on success
-1 on failure

Definition at line 63 of file file.c.

References ast_calloc, ast_log(), AST_RWLIST_INSERT_HEAD, AST_RWLIST_TRAVERSE, AST_RWLIST_UNLOCK, AST_RWLIST_WRLOCK, ast_verb, ast_format::buf_size, ast_format::exts, f, ast_format::list, LOG_WARNING, ast_format::module, and ast_format::name.

00064 {
00065    struct ast_format *tmp;
00066 
00067    AST_RWLIST_WRLOCK(&formats);
00068    AST_RWLIST_TRAVERSE(&formats, tmp, list) {
00069       if (!strcasecmp(f->name, tmp->name)) {
00070          AST_RWLIST_UNLOCK(&formats);
00071          ast_log(LOG_WARNING, "Tried to register '%s' format, already registered\n", f->name);
00072          return -1;
00073       }
00074    }
00075    if (!(tmp = ast_calloc(1, sizeof(*tmp)))) {
00076       AST_RWLIST_UNLOCK(&formats);
00077       return -1;
00078    }
00079    *tmp = *f;
00080    tmp->module = mod;
00081    if (tmp->buf_size) {
00082       /*
00083        * Align buf_size properly, rounding up to the machine-specific
00084        * alignment for pointers.
00085        */
00086       struct _test_align { void *a, *b; } p;
00087       int align = (char *)&p.b - (char *)&p.a;
00088       tmp->buf_size = ((f->buf_size + align - 1) / align) * align;
00089    }
00090    
00091    memset(&tmp->list, 0, sizeof(tmp->list));
00092 
00093    AST_RWLIST_INSERT_HEAD(&formats, tmp, list);
00094    AST_RWLIST_UNLOCK(&formats);
00095    ast_verb(2, "Registered file format %s, extension(s) %s\n", f->name, f->exts);
00096 
00097    return 0;
00098 }

int ast_format_unregister ( const char *  name  ) 

Unregisters a file format.

Parameters:
name the name of the format you wish to unregister Unregisters a format based on the name of the format.
Return values:
0 on success
-1 on failure to unregister

Definition at line 100 of file file.c.

References ast_free, ast_log(), AST_RWLIST_REMOVE_CURRENT, AST_RWLIST_TRAVERSE_SAFE_BEGIN, AST_RWLIST_TRAVERSE_SAFE_END, AST_RWLIST_UNLOCK, AST_RWLIST_WRLOCK, ast_verb, ast_format::list, LOG_WARNING, and ast_format::name.

Referenced by unload_module().

00101 {
00102    struct ast_format *tmp;
00103    int res = -1;
00104 
00105    AST_RWLIST_WRLOCK(&formats);
00106    AST_RWLIST_TRAVERSE_SAFE_BEGIN(&formats, tmp, list) {
00107       if (!strcasecmp(name, tmp->name)) {
00108          AST_RWLIST_REMOVE_CURRENT(list);
00109          ast_free(tmp);
00110          res = 0;
00111       }
00112    }
00113    AST_RWLIST_TRAVERSE_SAFE_END;
00114    AST_RWLIST_UNLOCK(&formats);
00115 
00116    if (!res)
00117       ast_verb(2, "Unregistered format %s\n", name);
00118    else
00119       ast_log(LOG_WARNING, "Tried to unregister format %s, already unregistered\n", name);
00120 
00121    return res;
00122 }


Generated on Sat Mar 10 01:55:31 2012 for Asterisk - The Open Source Telephony Project by  doxygen 1.4.7