Changeset 1942 for pjproject/trunk/pjmedia/include/pjmedia/rtcp.h

Timestamp:

Apr 28, 2008 6:05:49 PM (16 years ago)

Author:

bennylp

Message:

Ticket #513: Support for RTCP XR (initial patch)

File:

• pjproject/trunk/pjmedia/include/pjmedia/rtcp.h (modified) (6 diffs)

pjproject/trunk/pjmedia/include/pjmedia/rtcp.h

@@ -26 +26 @@
 
 #include <pjmedia/types.h>
+#include <pjmedia/rtcp_xr.h>
 #include <pjmedia/rtp.h>
 
@@ -247 +248 @@
 #endif
 
-
 /**
  * RTCP session is used to monitor the RTP session of one endpoint. There
@@ -255 +255 @@
 {
     char                   *name;       /**< Name identification.           */
-    pjmedia_rtcp_sr_pkt     rtcp_sr_pkt;/**< Cached RTCP packet.            */
+    pjmedia_rtcp_sr_pkt     rtcp_sr_pkt;/**< Cached RTCP SR packet.         */
     pjmedia_rtcp_rr_pkt     rtcp_rr_pkt;/**< Cached RTCP RR packet.         */
     
@@ -282 +282 @@
      */
     PJMEDIA_AVG_JITTER_TYPE avg_jitter; /**< Average RX jitter.             */
+
+#if defined(PJMEDIA_HAS_RTCP_XR) && (PJMEDIA_HAS_RTCP_XR != 0)
+    /**
+     * Specify whether RTCP XR processing is enabled on this session.
+     */
+    pj_bool_t               xr_enabled;
+
+    /**
+     * RTCP XR session, only valid if RTCP XR processing is enabled
+     * on this session.
+     */
+    pjmedia_rtcp_xr_session xr_session;
+#endif
 };
 
@@ -343 +356 @@
 
 /**
+ * Call this function everytime an RTP packet is received to let the RTCP
+ * session do its internal calculations.
+ *
+ * @param session   The session.
+ * @param seq       The RTP packet sequence number, in host byte order.
+ * @param ts        The RTP packet timestamp, in host byte order.
+ * @param payload   Size of the payload.
+ * @param discarded Flag to specify whether the packet is discarded.
+ */
+PJ_DECL(void) pjmedia_rtcp_rx_rtp2(pjmedia_rtcp_session *session, 
+                                   unsigned seq, 
+                                   unsigned ts,
+                                   unsigned payload,
+                                   pj_bool_t discarded);
+
+
+/**
  * Call this function everytime an RTP packet is sent to let the RTCP session
  * do its internal calculations.
@@ -386 +416 @@
 
 /**
+ * Call this function if RTCP XR needs to be enabled/disabled in the 
+ * RTCP session.
+ *
+ * @param session   The RTCP session.
+ * @param enable    Enable/disable RTCP XR.
+ *
+ * @return          PJ_SUCCESS on success.
+ */
+PJ_DECL(pj_status_t) pjmedia_rtcp_enable_xr( pjmedia_rtcp_session *session, 
+                                             pj_bool_t enable);
+
+
+/**
  * @}
  */