Wed Oct 28 11:46:09 2009

Asterisk developer's documentation


format_g723.c File Reference

Old-style G.723.1 frame/timestamp format. More...

#include "asterisk.h"
#include "asterisk/mod_format.h"
#include "asterisk/module.h"

Include dependency graph for format_g723.c:

Go to the source code of this file.

Defines

#define G723_MAX_SIZE   1024

Functions

static void __reg_module (void)
static void __unreg_module (void)
static struct ast_frameg723_read (struct ast_filestream *s, int *whennext)
static int g723_seek (struct ast_filestream *fs, off_t sample_offset, int whence)
static off_t g723_tell (struct ast_filestream *fs)
static int g723_trunc (struct ast_filestream *fs)
static int g723_write (struct ast_filestream *s, struct ast_frame *f)
static int load_module (void)
static int unload_module (void)

Variables

static struct ast_module_info __mod_info = { .name = AST_MODULE, .flags = AST_MODFLAG_DEFAULT , .description = "G.723.1 Simple Timestamp File Format" , .key = "This paragraph is copyright (c) 2006 by Digium, Inc. \In order for your module to load, it must return this \key via a function called \"key\". Any code which \includes this paragraph must be licensed under the GNU \General Public License version 2 or later (at your \option). In addition to Digium's general reservations \of rights, Digium expressly reserves the right to \allow other parties to license this paragraph under \different terms. Any use of Digium, Inc. trademarks or \logos (including \"Asterisk\" or \"Digium\") without \express written permission of Digium, Inc. is prohibited.\n" , .buildopt_sum = AST_BUILDOPT_SUM, .load = load_module, .unload = unload_module, }
static const struct
ast_module_info
ast_module_info = &__mod_info
static struct ast_format g723_1_f


Detailed Description

Old-style G.723.1 frame/timestamp format.

Definition in file format_g723.c.


Define Documentation

#define G723_MAX_SIZE   1024

Definition at line 35 of file format_g723.c.

Referenced by g723_read().


Function Documentation

static void __reg_module ( void   )  [static]

Definition at line 152 of file format_g723.c.

static void __unreg_module ( void   )  [static]

Definition at line 152 of file format_g723.c.

static struct ast_frame* g723_read ( struct ast_filestream s,
int *  whennext 
) [static, read]

Definition at line 37 of file format_g723.c.

References AST_FORMAT_G723_1, AST_FRAME_SET_BUFFER, AST_FRAME_VOICE, AST_FRIENDLY_OFFSET, ast_log(), ast_filestream::buf, ast_frame::data, ast_frame::datalen, errno, ast_filestream::f, ast_filestream::fr, ast_frame::frametype, G723_MAX_SIZE, LOG_WARNING, ast_frame::mallocd, ast_frame::samples, and ast_frame::subclass.

00038 {
00039    unsigned short size;
00040    int res;
00041    int delay;
00042    /* Read the delay for the next packet, and schedule again if necessary */
00043    /* XXX is this ignored ? */
00044    if (fread(&delay, 1, 4, s->f) == 4) 
00045       delay = ntohl(delay);
00046    else
00047       delay = -1;
00048    if (fread(&size, 1, 2, s->f) != 2) {
00049       /* Out of data, or the file is no longer valid.  In any case
00050          go ahead and stop the stream */
00051       return NULL;
00052    }
00053    /* Looks like we have a frame to read from here */
00054    size = ntohs(size);
00055    if (size > G723_MAX_SIZE) {
00056       ast_log(LOG_WARNING, "Size %d is invalid\n", size);
00057       /* The file is apparently no longer any good, as we
00058          shouldn't ever get frames even close to this 
00059          size.  */
00060       return NULL;
00061    }
00062    /* Read the data into the buffer */
00063    s->fr.frametype = AST_FRAME_VOICE;
00064    s->fr.subclass = AST_FORMAT_G723_1;
00065    s->fr.mallocd = 0;
00066    AST_FRAME_SET_BUFFER(&s->fr, s->buf, AST_FRIENDLY_OFFSET, size);
00067    if ((res = fread(s->fr.data, 1, s->fr.datalen, s->f)) != size) {
00068       ast_log(LOG_WARNING, "Short read (%d of %d bytes) (%s)!\n", res, size, strerror(errno));
00069       return NULL;
00070    }
00071    *whennext = s->fr.samples = 240;
00072    return &s->fr;
00073 }

static int g723_seek ( struct ast_filestream fs,
off_t  sample_offset,
int  whence 
) [static]

Definition at line 110 of file format_g723.c.

00111 {
00112    return -1;
00113 }

static off_t g723_tell ( struct ast_filestream fs  )  [static]

Definition at line 123 of file format_g723.c.

00124 {
00125    return -1;
00126 }

static int g723_trunc ( struct ast_filestream fs  )  [static]

Definition at line 115 of file format_g723.c.

References ast_filestream::f.

00116 {
00117    /* Truncate file to current length */
00118    if (ftruncate(fileno(fs->f), ftello(fs->f)) < 0)
00119       return -1;
00120    return 0;
00121 }

static int g723_write ( struct ast_filestream s,
struct ast_frame f 
) [static]

Definition at line 75 of file format_g723.c.

References AST_FORMAT_G723_1, AST_FRAME_VOICE, ast_log(), ast_frame::data, ast_frame::datalen, errno, ast_filestream::f, ast_frame::frametype, LOG_WARNING, and ast_frame::subclass.

00076 {
00077    uint32_t delay;
00078    uint16_t size;
00079    int res;
00080    /* XXX there used to be a check s->fr means a read stream */
00081    if (f->frametype != AST_FRAME_VOICE) {
00082       ast_log(LOG_WARNING, "Asked to write non-voice frame!\n");
00083       return -1;
00084    }
00085    if (f->subclass != AST_FORMAT_G723_1) {
00086       ast_log(LOG_WARNING, "Asked to write non-g723 frame!\n");
00087       return -1;
00088    }
00089    delay = 0;
00090    if (f->datalen <= 0) {
00091       ast_log(LOG_WARNING, "Short frame ignored (%d bytes long?)\n", f->datalen);
00092       return 0;
00093    }
00094    if ((res = fwrite(&delay, 1, 4, s->f)) != 4) {
00095       ast_log(LOG_WARNING, "Unable to write delay: res=%d (%s)\n", res, strerror(errno));
00096       return -1;
00097    }
00098    size = htons(f->datalen);
00099    if ((res = fwrite(&size, 1, 2, s->f)) != 2) {
00100       ast_log(LOG_WARNING, "Unable to write size: res=%d (%s)\n", res, strerror(errno));
00101       return -1;
00102    }
00103    if ((res = fwrite(f->data, 1, f->datalen, s->f)) != f->datalen) {
00104       ast_log(LOG_WARNING, "Unable to write frame: res=%d (%s)\n", res, strerror(errno));
00105       return -1;
00106    }  
00107    return 0;
00108 }

static int load_module ( void   )  [static]

Definition at line 140 of file format_g723.c.

References ast_format_register, AST_MODULE_LOAD_FAILURE, and AST_MODULE_LOAD_SUCCESS.

00141 {
00142    if (ast_format_register(&g723_1_f))
00143       return AST_MODULE_LOAD_FAILURE;
00144    return AST_MODULE_LOAD_SUCCESS;
00145 }

static int unload_module ( void   )  [static]

Definition at line 147 of file format_g723.c.

References ast_format_unregister(), and ast_format::name.

00148 {
00149    return ast_format_unregister(g723_1_f.name);
00150 }  


Variable Documentation

struct ast_module_info __mod_info = { .name = AST_MODULE, .flags = AST_MODFLAG_DEFAULT , .description = "G.723.1 Simple Timestamp File Format" , .key = "This paragraph is copyright (c) 2006 by Digium, Inc. \In order for your module to load, it must return this \key via a function called \"key\". Any code which \includes this paragraph must be licensed under the GNU \General Public License version 2 or later (at your \option). In addition to Digium's general reservations \of rights, Digium expressly reserves the right to \allow other parties to license this paragraph under \different terms. Any use of Digium, Inc. trademarks or \logos (including \"Asterisk\" or \"Digium\") without \express written permission of Digium, Inc. is prohibited.\n" , .buildopt_sum = AST_BUILDOPT_SUM, .load = load_module, .unload = unload_module, } [static]

Definition at line 152 of file format_g723.c.

const struct ast_module_info* ast_module_info = &__mod_info [static]

Definition at line 152 of file format_g723.c.

struct ast_format g723_1_f [static]

Definition at line 128 of file format_g723.c.


Generated on Wed Oct 28 11:46:09 2009 for Asterisk - the Open Source PBX by  doxygen 1.5.6