Changeset 3159 for pjproject/trunk/pjmedia/include/pjmedia-audiodev/audiodev.h

Timestamp:

May 5, 2010 4:23:27 AM (13 years ago)

Author:

ming

Message:

Implemented ticket #1065: audiodev register/unregister feature

File:

• pjproject/trunk/pjmedia/include/pjmedia-audiodev/audiodev.h (modified) (3 diffs)

pjproject/trunk/pjmedia/include/pjmedia-audiodev/audiodev.h

@@ -40 +40 @@
  */
 
-/** 
+/**
  * Type for device index.
  */
@@ -429 +429 @@
 typedef struct pjmedia_aud_dev_factory pjmedia_aud_dev_factory;
 
+/* typedef for factory creation function */
+typedef pjmedia_aud_dev_factory*
+(*pjmedia_aud_dev_factory_create_func_ptr)(pj_pool_factory*);
+
+
 /**
  * Get string info for the specified capability.
@@ -508 +513 @@
  */
 PJ_DECL(pj_status_t) pjmedia_aud_subsys_shutdown(void);
+
+
+/**
+ * Register a supported audio device factory to the audio subsystem. This
+ * function can only be called after calling #pjmedia_aud_subsys_init().
+ *
+ * @param adf           The audio device factory.
+ *
+ * @return              PJ_SUCCESS on successful operation or the appropriate
+ *                      error code.
+ */
+PJ_DECL(pj_status_t)
+pjmedia_aud_register_factory(pjmedia_aud_dev_factory_create_func_ptr adf);
+
+
+/**
+ * Unregister an audio device factory from the audio subsystem. This
+ * function can only be called after calling #pjmedia_aud_subsys_init().
+ * Devices from this factory will be unlisted. If a device from this factory
+ * is currently in use, then the behavior is undefined.
+ *
+ * @param adf           The audio device factory.
+ *
+ * @return              PJ_SUCCESS on successful operation or the appropriate
+ *                      error code.
+ */
+PJ_DECL(pj_status_t)
+pjmedia_aud_unregister_factory(pjmedia_aud_dev_factory_create_func_ptr adf);