From 6a53ae2cd676fa9045c0ef44b5dcb6c1fa6e6508 Mon Sep 17 00:00:00 2001 From: kpfleming Date: Tue, 24 Oct 2006 03:45:42 +0000 Subject: add an API call to allow channel drivers to determine which media formats are compatible (passthrough or transcode) with the format an existing channel is already using git-svn-id: http://svn.digium.com/svn/asterisk/branches/1.4@46082 f38db490-d61c-443f-a65b-d21fe96a405b --- include/asterisk/translate.h | 18 ++++++++++++++++-- 1 file changed, 16 insertions(+), 2 deletions(-) (limited to 'include') diff --git a/include/asterisk/translate.h b/include/asterisk/translate.h index 07c0ae1c2..a03f54ef2 100644 --- a/include/asterisk/translate.h +++ b/include/asterisk/translate.h @@ -205,12 +205,26 @@ struct ast_frame *ast_translate(struct ast_trans_pvt *tr, struct ast_frame *f, i /*! * \brief Returns the number of steps required to convert from 'src' to 'dest'. - * \param dest Destination format - * \param src Source format + * \param dest destination format + * \param src source format * \return the number of translation steps required, or -1 if no path is available */ unsigned int ast_translate_path_steps(unsigned int dest, unsigned int src); +/*! + * \brief Mask off unavailable formats from a format bitmask + * \param dest possible destination formats + * \param src source formats + * \return the destination formats that are available in the source or translatable + * + * The result will include all formats from 'dest' that are either present + * in 'src' or translatable from a format present in 'src'. + * + * Note that only a single audio format and a single video format can be + * present in 'src', or the function will produce unexpected results. + */ +unsigned int ast_translate_available_formats(unsigned int dest, unsigned int src); + #if defined(__cplusplus) || defined(c_plusplus) } #endif -- cgit v1.2.3