Changeset 498 for pjproject/trunk/pjmedia/include/pjmedia/master_port.h

Timestamp:

Jun 12, 2006 10:13:31 AM (18 years ago)

Author:

bennylp

Message:

Added mutex protection and option not to delete upstream/downstream port in master_port.c

File:

• pjproject/trunk/pjmedia/include/pjmedia/master_port.h (modified) (4 diffs)

pjproject/trunk/pjmedia/include/pjmedia/master_port.h

@@ -53 +53 @@
  * @param u_port        Upstream port.
  * @param d_port        Downstream port.
- * @param options       Options flags.
+ * @param options       Options flags, bitmask from #pjmedia_master_port_flag.
  * @param p_m           Pointer to receive the master port instance.
  *
@@ -65 +65 @@
 
 
-
 /**
  * Start the media flow.
@@ -74 +73 @@
  */
 PJ_DECL(pj_status_t) pjmedia_master_port_start(pjmedia_master_port *m);
-
 
 
@@ -88 +86 @@
 
 /**
+ * Change the upstream port. Note that application is responsible to destroy
+ * current upstream port (the one that is going to be replaced with the
+ * new port).
+ *
+ * @param m             The master port.
+ * @param port          Port to be used for upstream port.
+ *
+ * @return              PJ_SUCCESS on success.
+ */
+PJ_DECL(pj_status_t) pjmedia_master_port_set_uport(pjmedia_master_port *m,
+                                                   pjmedia_port *port);
+
+
+/**
+ * Get the upstream port.
+ *
+ * @param m             The master port.
+ *
+ * @return              The upstream port.
+ */
+PJ_DECL(pjmedia_port*) pjmedia_master_port_get_uport(pjmedia_master_port*m);
+
+
+/**
+ * Change the downstream port. Note that application is responsible to destroy
+ * current downstream port (the one that is going to be replaced with the
+ * new port).
+ *
+ * @param m             The master port.
+ * @param port          Port to be used for downstream port.
+ *
+ * @return              PJ_SUCCESS on success.
+ */
+PJ_DECL(pj_status_t) pjmedia_master_port_set_dport(pjmedia_master_port *m,
+                                                   pjmedia_port *port);
+
+
+/**
+ * Get the downstream port.
+ *
+ * @param m             The master port.
+ *
+ * @return              The downstream port.
+ */
+PJ_DECL(pjmedia_port*) pjmedia_master_port_get_dport(pjmedia_master_port*m);
+
+
+/**
  * Destroy the master port, and optionally destroy the upstream and 
  * downstream ports.
  *
  * @param m             The master port.
+ * @param destroy_ports If non-zero, the function will destroy both
+ *                      upstream and downstream ports too.
  *
  * @return              PJ_SUCCESS on success.
  */
-PJ_DECL(pj_status_t) pjmedia_master_port_destroy(pjmedia_master_port *m);
+PJ_DECL(pj_status_t) pjmedia_master_port_destroy(pjmedia_master_port *m,
+                                                 pj_bool_t destroy_ports);