Changeset 4748 for pjproject/trunk/third_party/bdsound/include/bdimad.h

Timestamp:

Feb 18, 2014 1:41:45 AM (8 years ago)

Author:

bennylp

Message:

Fixed #1736: Update to bdSound's bdiMad audio device to support output routing. Thanks Andrea for the patch.

File:

• pjproject/trunk/third_party/bdsound/include/bdimad.h (modified) (5 diffs)

pjproject/trunk/third_party/bdsound/include/bdimad.h

@@ -52 +52 @@
  *    - <b>Usage</b>
  *    \n There are only a couple of things the customer have to pay attention on
- *    §when using bdIMAD library.
+ *    ï¿œwhen using bdIMAD library.
  *
  *       - <b>Initialization</b>
@@ -341 +341 @@
 } bdIMADpj_libVersion_t;
 
+
+/**
+ * @brief Audio output routing setting to pass to set and get route output device functions.
+ */
+typedef enum bdIMADpj_out_dev_route{
+    /** Default route. */
+    BD_AUD_DEV_ROUTE_DEFAULT = 0,
+
+    /** Route to loudspeaker */
+    BD_AUD_DEV_ROUTE_LOUDSPEAKER = 1,
+
+    /** Route to earpiece */
+    BD_AUD_DEV_ROUTE_EARPIECE = 2
+}bdIMADpj_out_dev_route;
+
+
 /**
  * @}
@@ -409 +425 @@
  *                                     is modified with the applied settings.
  * @param[out] **ppWarningMessages     Pointer to pointer to a
- *                                     ::bdIMADpj_Warnings_t sructure,
+ *                                     ::bdIMADpj_Warnings_t structure,
  *                                     which reports the warnings after the
  *                                     initialization.
@@ -514 +530 @@
  *                                     performed successfully, otherwise
  *                                     return an error (refer to
- *                                     §::bdIMADpj_Status).
+ *                                     ￜ::bdIMADpj_Status).
  */
 BDIMADPJ_API bdIMADpj_Status bdIMADpj_setParameter(bdIMADpj bdIMADInstance,
@@ -537 +553 @@
                                 bdIMADpj_Parameter parameterName, void *pValue);
 
+/**
+ * @brief Is used to set the route of the output device of the bdIMAD object pointed by the
+ * <code>pBdIMADInstance</code>.
+ * @param[in] bdIMADInstance           bdIMAD object.
+ * @param[in] outputRoute              Indicate the route of the output device to set.
+ * @param[out] **ppWarningMessages     Pointer to pointer to a
+ *                                     ::bdIMADpj_Warnings_t structure,
+ *                                     which reports the warnings after the
+ *                                     set function.
+ * @return                             ::BD_PJ_OK if the function has been
+ *                                     performed successfully, otherwise return
+ *                                     an error (refer to ::bdIMADpj_Status).
+ */
+BDIMADPJ_API bdIMADpj_Status bdIMADpj_setRouteOutputDevice(bdIMADpj bdIMADInstance, bdIMADpj_out_dev_route outputRoute, bdIMADpj_Warnings_t **ppWarningMessages);
+
+/**
+ * @brief Is used to get the route of the output device of the bdIMAD object pointed by the
+ * <code>pBdIMADInstance</code>.
+ * @param[in] bdIMADInstance           bdIMAD object.
+ * @param[out] *outputRoute            Is a pointer to the route of the output device currently setted.
+ * @return                             ::BD_PJ_OK if the function has been
+ *                                     performed successfully, otherwise return
+ *                                     an error (refer to ::bdIMADpj_Status).
+ */
+BDIMADPJ_API bdIMADpj_Status bdIMADpj_getRouteOutputDevice(bdIMADpj bdIMADInstance, bdIMADpj_out_dev_route *outputRoute);
 
 #ifdef __cplusplus