Changeset 3632 for pjproject/branches/projects/2.0-dev/pjsip/include/pjsua-lib/pjsua.h

Timestamp:

Jul 13, 2011 3:05:22 AM (13 years ago)

Author:

bennylp

Message:

Fixed #1299: New callback to notify that sound device needs to be opened or closed

File:

• pjproject/branches/projects/2.0-dev/pjsip/include/pjsua-lib/pjsua.h (modified) (1 diff)

pjproject/branches/projects/2.0-dev/pjsip/include/pjsua-lib/pjsua.h

@@ -962 +962 @@
                                    pj_status_t status, void *param);
 
+    /**
+     * Callback when the sound device is about to be opened or closed.
+     * This callback will be called even when null sound device or no
+     * sound device is configured by the application (i.e. the
+     * #pjsua_set_null_snd_dev() and #pjsua_set_no_snd_dev() APIs).
+     * This API is mostly useful when the application wants to manage
+     * the sound device by itself (i.e. with #pjsua_set_no_snd_dev()),
+     * to get notified when it should open or close the sound device.
+     *
+     * @param operation The value will be set to 0 to signal that sound
+     *                  device is about to be closed, and 1 to be opened.
+     *
+     * @return          The callback must return PJ_SUCCESS at the moment.
+     */
+    pj_status_t (*on_snd_dev_operation)(int operation);
+
+
 } pjsua_callback;