Changeset 867 for pjproject/trunk/pjmedia/include/pjmedia/codec.h

Timestamp:

Dec 26, 2006 9:18:11 PM (17 years ago)

Author:

bennylp

Message:

Ticket #54: added ability to modify some codec parameters on the fly

File:

• pjproject/trunk/pjmedia/include/pjmedia/codec.h (modified) (2 diffs)

pjproject/trunk/pjmedia/include/pjmedia/codec.h

@@ -315 +315 @@
      */
     pj_status_t (*open)(pjmedia_codec *codec, 
-                        pjmedia_codec_param *param );
+                        const pjmedia_codec_param *param );
 
     /** 
@@ -327 +327 @@
     pj_status_t (*close)(pjmedia_codec *codec);
 
+    /** 
+     * Modify the codec parameter after the codec is open. 
+     * Note that not all codec parameters can be modified during run-time. 
+     * When the parameter cannot be changed, this function will return 
+     * non-PJ_SUCCESS, and the original parameters will not be changed.
+     *
+     * Application can expect changing trivial codec settings such as
+     * changing VAD setting to succeed.
+     *
+     * @param codec     The codec instance.
+     * @param param     The new codec parameter.
+     *
+     * @return          PJ_SUCCESS on success.
+     */
+    pj_status_t (*modify)(pjmedia_codec *codec, 
+                          const pjmedia_codec_param *param );
 
     /**