/* $Id$ */ /* * Copyright (C) 2008-2011 Teluu Inc. (http://www.teluu.com) * * This program is free software; you can redistribute it and/or modify * it under the terms of the GNU 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 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA */ #include #include #include #include #if PJMEDIA_AUDIO_DEV_HAS_NULL_AUDIO #define THIS_FILE "null_dev.c" /* null_audio device info */ struct null_audio_dev_info { pjmedia_aud_dev_info info; unsigned dev_id; }; /* null_audio factory */ struct null_audio_factory { pjmedia_aud_dev_factory base; pj_pool_t *pool; pj_pool_factory *pf; unsigned dev_count; struct null_audio_dev_info *dev_info; }; /* Sound stream. */ struct null_audio_stream { pjmedia_aud_stream base; /**< Base stream */ pjmedia_aud_param param; /**< Settings */ pj_pool_t *pool; /**< Memory pool. */ pjmedia_aud_rec_cb rec_cb; /**< Capture callback. */ pjmedia_aud_play_cb play_cb; /**< Playback callback. */ void *user_data; /**< Application data. */ }; /* Prototypes */ static pj_status_t null_factory_init(pjmedia_aud_dev_factory *f); static pj_status_t null_factory_destroy(pjmedia_aud_dev_factory *f); static pj_status_t null_factory_refresh(pjmedia_aud_dev_factory *f); static unsigned null_factory_get_dev_count(pjmedia_aud_dev_factory *f); static pj_status_t null_factory_get_dev_info(pjmedia_aud_dev_factory *f, unsigned index, pjmedia_aud_dev_info *info); static pj_status_t null_factory_default_param(pjmedia_aud_dev_factory *f, unsigned index, pjmedia_aud_param *param); static pj_status_t null_factory_create_stream(pjmedia_aud_dev_factory *f, const pjmedia_aud_param *param, pjmedia_aud_rec_cb rec_cb, pjmedia_aud_play_cb play_cb, void *user_data, pjmedia_aud_stream **p_aud_strm); static pj_status_t null_stream_get_param(pjmedia_aud_stream *strm, pjmedia_aud_param *param); static pj_status_t null_stream_get_cap(pjmedia_aud_stream *strm, pjmedia_aud_dev_cap cap, void *value); static pj_status_t null_stream_set_cap(pjmedia_aud_stream *strm, pjmedia_aud_dev_cap cap, const void *value); static pj_status_t null_stream_start(pjmedia_aud_stream *strm); static pj_status_t null_stream_stop(pjmedia_aud_stream *strm); static pj_status_t null_stream_destroy(pjmedia_aud_stream *strm); /* Operations */ static pjmedia_aud_dev_factory_op factory_op = { &null_factory_init, &null_factory_destroy, &null_factory_get_dev_count, &null_factory_get_dev_info, &null_factory_default_param, &null_factory_create_stream, &null_factory_refresh }; static pjmedia_aud_stream_op stream_op = { &null_stream_get_param, &null_stream_get_cap, &null_stream_set_cap, &null_stream_start, &null_stream_stop, &null_stream_destroy }; /**************************************************************************** * Factory operations */ /* * Init null_audio audio driver. */ pjmedia_aud_dev_factory* pjmedia_null_audio_factory(pj_pool_factory *pf) { struct null_audio_factory *f; pj_pool_t *pool; pool = pj_pool_create(pf, "null audio", 1000, 1000, NULL); f = PJ_POOL_ZALLOC_T(pool, struct null_audio_factory); f->pf = pf; f->pool = pool; f->base.op = &factory_op; return &f->base; } /* API: init factory */ static pj_status_t null_factory_init(pjmedia_aud_dev_factory *f) { struct null_audio_factory *nf = (struct null_audio_factory*)f; struct null_audio_dev_info *ndi; /* Initialize input and output devices here */ nf->dev_count = 1; nf->dev_info = (struct null_audio_dev_info*) pj_pool_calloc(nf->pool, nf->dev_count, sizeof(struct null_audio_dev_info)); ndi = &nf->dev_info[0]; pj_bzero(ndi, sizeof(*ndi)); strcpy(ndi->info.name, "null device"); strcpy(ndi->info.driver, "null"); ndi->info.input_count = 1; ndi->info.output_count = 1; ndi->info.default_samples_per_sec = 16000; /* Set the device capabilities here */ ndi->info.caps = 0; PJ_LOG(4, (THIS_FILE, "null audio initialized")); return PJ_SUCCESS; } /* API: destroy factory */ static pj_status_t null_factory_destroy(pjmedia_aud_dev_factory *f) { struct null_audio_factory *nf = (struct null_audio_factory*)f; pj_pool_t *pool = nf->pool; nf->pool = NULL; pj_pool_release(pool); return PJ_SUCCESS; } /* API: refresh the list of devices */ static pj_status_t null_factory_refresh(pjmedia_aud_dev_factory *f) { PJ_UNUSED_ARG(f); return PJ_SUCCESS; } /* API: get number of devices */ static unsigned null_factory_get_dev_count(pjmedia_aud_dev_factory *f) { struct null_audio_factory *nf = (struct null_audio_factory*)f; return nf->dev_count; } /* API: get device info */ static pj_status_t null_factory_get_dev_info(pjmedia_aud_dev_factory *f, unsigned index, pjmedia_aud_dev_info *info) { struct null_audio_factory *nf = (struct null_audio_factory*)f; PJ_ASSERT_RETURN(index < nf->dev_count, PJMEDIA_EAUD_INVDEV); pj_memcpy(info, &nf->dev_info[index].info, sizeof(*info)); return PJ_SUCCESS; } /* API: create default device parameter */ static pj_status_t null_factory_default_param(pjmedia_aud_dev_factory *f, unsigned index, pjmedia_aud_param *param) { struct null_audio_factory *nf = (struct null_audio_factory*)f; struct null_audio_dev_info *di = &nf->dev_info[index]; PJ_ASSERT_RETURN(index < nf->dev_count, PJMEDIA_EAUD_INVDEV); pj_bzero(param, sizeof(*param)); if (di->info.input_count && di->info.output_count) { param->dir = PJMEDIA_DIR_CAPTURE_PLAYBACK; param->rec_id = index; param->play_id = index; } else if (di->info.input_count) { param->dir = PJMEDIA_DIR_CAPTURE; param->rec_id = index; param->play_id = PJMEDIA_AUD_INVALID_DEV; } else if (di->info.output_count) { param->dir = PJMEDIA_DIR_PLAYBACK; param->play_id = index; param->rec_id = PJMEDIA_AUD_INVALID_DEV; } else { return PJMEDIA_EAUD_INVDEV; } /* Set the mandatory settings here */ /* The values here are just some examples */ param->clock_rate = di->info.default_samples_per_sec; param->channel_count = 1; param->samples_per_frame = di->info.default_samples_per_sec * 20 / 1000; param->bits_per_sample = 16; /* Set the device capabilities here */ param->flags = 0; return PJ_SUCCESS; } /* API: create stream */ static pj_status_t null_factory_create_stream(pjmedia_aud_dev_factory *f, const pjmedia_aud_param *param, pjmedia_aud_rec_cb rec_cb, pjmedia_aud_play_cb play_cb, void *user_data, pjmedia_aud_stream **p_aud_strm) { struct null_audio_factory *nf = (struct null_audio_factory*)f; pj_pool_t *pool; struct null_audio_stream *strm; /* Create and Initialize stream descriptor */ pool = pj_pool_create(nf->pf, "null_audio-dev", 1000, 1000, NULL); PJ_ASSERT_RETURN(pool != NULL, PJ_ENOMEM); strm = PJ_POOL_ZALLOC_T(pool, struct null_audio_stream); pj_memcpy(&strm->param, param, sizeof(*param)); strm->pool = pool; strm->rec_cb = rec_cb; strm->play_cb = play_cb; strm->user_data = user_data; /* Create player stream here */ if (param->dir & PJMEDIA_DIR_PLAYBACK) { } /* Create capture stream here */ if (param->dir & PJMEDIA_DIR_CAPTURE) { } /* Apply the remaining settings */ /* Below is an example if you want to set the output volume */ if (param->flags & PJMEDIA_AUD_DEV_CAP_OUTPUT_VOLUME_SETTING) { null_stream_set_cap(&strm->base, PJMEDIA_AUD_DEV_CAP_OUTPUT_VOLUME_SETTING, ¶m->output_vol); } /* Done */ strm->base.op = &stream_op; *p_aud_strm = &strm->base; return PJ_SUCCESS; } /* API: Get stream info. */ static pj_status_t null_stream_get_param(pjmedia_aud_stream *s, pjmedia_aud_param *pi) { struct null_audio_stream *strm = (struct null_audio_stream*)s; PJ_ASSERT_RETURN(strm && pi, PJ_EINVAL); pj_memcpy(pi, &strm->param, sizeof(*pi)); /* Example: Update the volume setting */ if (null_stream_get_cap(s, PJMEDIA_AUD_DEV_CAP_OUTPUT_VOLUME_SETTING, &pi->output_vol) == PJ_SUCCESS) { pi->flags |= PJMEDIA_AUD_DEV_CAP_OUTPUT_VOLUME_SETTING; } return PJ_SUCCESS; } /* API: get capability */ static pj_status_t null_stream_get_cap(pjmedia_aud_stream *s, pjmedia_aud_dev_cap cap, void *pval) { struct null_audio_stream *strm = (struct null_audio_stream*)s; PJ_UNUSED_ARG(strm); PJ_ASSERT_RETURN(s && pval, PJ_EINVAL); /* Example: Get the output's volume setting */ if (cap==PJMEDIA_AUD_DEV_CAP_OUTPUT_VOLUME_SETTING) { /* Output volume setting */ *(unsigned*)pval = 0; // retrieve output device's volume here return PJ_SUCCESS; } else { return PJMEDIA_EAUD_INVCAP; } } /* API: set capability */ static pj_status_t null_stream_set_cap(pjmedia_aud_stream *s, pjmedia_aud_dev_cap cap, const void *pval) { struct null_audio_stream *strm = (struct null_audio_stream*)s; PJ_UNUSED_ARG(strm); PJ_ASSERT_RETURN(s && pval, PJ_EINVAL); /* Example */ if (cap==PJMEDIA_AUD_DEV_CAP_OUTPUT_VOLUME_SETTING) { /* Output volume setting */ // set output's volume level here return PJ_SUCCESS; } return PJMEDIA_EAUD_INVCAP; } /* API: Start stream. */ static pj_status_t null_stream_start(pjmedia_aud_stream *strm) { struct null_audio_stream *stream = (struct null_audio_stream*)strm; PJ_UNUSED_ARG(stream); PJ_LOG(4, (THIS_FILE, "Starting null audio stream")); return PJ_SUCCESS; } /* API: Stop stream. */ static pj_status_t null_stream_stop(pjmedia_aud_stream *strm) { struct null_audio_stream *stream = (struct null_audio_stream*)strm; PJ_UNUSED_ARG(stream); PJ_LOG(4, (THIS_FILE, "Stopping null audio stream")); return PJ_SUCCESS; } /* API: Destroy stream. */ static pj_status_t null_stream_destroy(pjmedia_aud_stream *strm) { struct null_audio_stream *stream = (struct null_audio_stream*)strm; PJ_ASSERT_RETURN(stream != NULL, PJ_EINVAL); null_stream_stop(strm); pj_pool_release(stream->pool); return PJ_SUCCESS; } #endif /* PJMEDIA_AUDIO_DEV_HAS_NULL_AUDIO */