Changeset 2845 for pjproject/trunk/pjmedia/include/pjmedia/transport_loop.h

Timestamp:

Jul 29, 2009 12:19:25 PM (15 years ago)

Author:

bennylp

Message:

Ticket #924: Loop media transport now allows more than one streams to receive the reflected packets

• This ticket allows the same loop media transport instance to be attached to more than one streams, and allow application to control which stream(s) receives the reflected packets.

File:

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

pjproject/trunk/pjmedia/include/pjmedia/transport_loop.h

@@ -36 +36 @@
  * @{
  *
- * This is the loopback media transport, where packet sent to this transport
- * will immediately be sent back to the callback.
+ * This is the loopback media transport, where packets sent to this transport
+ * will be sent back to the streams attached to this transport. Unlike the
+ * other PJMEDIA transports, the loop transport may be attached to multiple
+ * streams (in other words, application should specify the same loop transport
+ * instance when calling #pjmedia_stream_create()). Any RTP or RTCP packets
+ * sent by one stream to this transport by default will be sent back to all 
+ * streams that are attached to this transport, including to the stream that
+ * sends the packet. Application may individually select which stream to
+ * receive packets by calling #pjmedia_transport_loop_disable_rx().
  */
 
@@ -55 +62 @@
 
 
+/**
+ * Set this stream as the receiver of incoming packets.
+ */
+PJ_DECL(pj_status_t) pjmedia_transport_loop_disable_rx(pjmedia_transport *tp,
+                                                       void *user,
+                                                       pj_bool_t disabled);