main/format: Add an API call for retrieving format attributes
[asterisk/asterisk.git] / include / asterisk / format.h
index c99c8f3..a5ca038 100644 (file)
@@ -120,6 +120,18 @@ struct ast_format_interface {
         */
        void (* const format_generate_sdp_fmtp)(const struct ast_format *format, unsigned int payload,
                struct ast_str **str);
         */
        void (* const format_generate_sdp_fmtp)(const struct ast_format *format, unsigned int payload,
                struct ast_str **str);
+
+       /*!
+        * \since 13.6.0
+        * \brief Retrieve a particular format attribute setting
+        *
+        * \param format The format containing attributes
+        * \param name The name of the attribute to retrieve
+        *
+        * \retval NULL if the parameter is not set on the format
+        * \retval non-NULL the format attribute value
+        */
+       const void *(* const format_attribute_get)(const struct ast_format *format, const char *name);
 };
 
 /*!
 };
 
 /*!
@@ -204,6 +216,17 @@ struct ast_format *ast_format_attribute_set(const struct ast_format *format, con
        const char *value);
 
 /*!
        const char *value);
 
 /*!
+ * \since 13.6.0
+ *
+ * \param format The format to retrieve the attribute from
+ * \param name Attribute name
+ *
+ * \retval non-NULL the attribute value
+ * \retval NULL the attribute does not exist or is unset
+ */
+const void *ast_format_attribute_get(const struct ast_format *format, const char *name);
+
+/*!
  * \brief This function is used to have a media format aware module parse and interpret
  * SDP attribute information. Once interpreted this information is stored on the format
  * itself using Asterisk format attributes.
  * \brief This function is used to have a media format aware module parse and interpret
  * SDP attribute information. Once interpreted this information is stored on the format
  * itself using Asterisk format attributes.