Changeset 1698 for pjproject/branches/users/nanang/pjmedia/include/pjmedia/transport.h

Timestamp:

Jan 17, 2008 5:29:36 PM (16 years ago)

Author:

nanang

Message:

Ticket #452:

• Add directory srtp to third_party/build directory
• Add libsrtp project & integrate it to pjproject vs8 solution
• Add transport_srtp.h & .c
• Modify project dependencies to include libsrtp
• Modify Samples-vc.mak, add libsrtp as third party library
• Modify transport interface
• Modify transport_ice & transport_udp to accomodate new transport interface
• Modify other files that uses transport

File:

• pjproject/branches/users/nanang/pjmedia/include/pjmedia/transport.h (modified) (4 diffs)

pjproject/branches/users/nanang/pjmedia/include/pjmedia/transport.h

@@ -172 +172 @@
  */
 typedef struct pjmedia_transport pjmedia_transport;
+typedef struct pjmedia_sdp_session pjmedia_sdp_session;
 
 
@@ -243 +244 @@
                              const void *pkt,
                              pj_size_t size);
+
+    /**
+     * This function is called by application to generate the SDP parts
+     * related to transport type, e.g: ICE, SRTP.
+     *
+     * Application should call #pjmedia_transport_media_create() instead of 
+     * calling this function directly.
+     */
+    pj_status_t (*media_create)(pjmedia_transport *tp,
+                                pj_pool_t *pool,
+                                pjmedia_sdp_session *sdp_local,
+                                const pjmedia_sdp_session *sdp_remote);
+
+    /**
+     * This function is called by application to start the transport
+     * based on SDP negotiation result.
+     *
+     * Application should call #pjmedia_transport_media_start() instead of 
+     * calling this function directly.
+     */
+    pj_status_t (*media_start) (pjmedia_transport *tp,
+                                pj_pool_t *pool,
+                                pjmedia_sdp_session *sdp_local,
+                                const pjmedia_sdp_session *sdp_remote,
+                                unsigned media_index);
+
+    /**
+     * This function is called by application to stop the transport.
+     *
+     * Application should call #pjmedia_transport_media_stop() instead of 
+     * calling this function directly.
+     */
+    pj_status_t (*media_stop)  (pjmedia_transport *tp);
+
+    /**
+     * This function can be called to simulate packet lost.
+     *
+     * Application should call #pjmedia_transport_simulate_lost() instead of 
+     * calling this function directly.
+     */
+    pj_status_t (*simulate_lost)(pjmedia_transport *tp,
+                                 pjmedia_dir dir,
+                                 unsigned pct_lost);
 
     /**
@@ -411 +455 @@
 
 /**
+ * Generate local SDP parts that are related to the specified media transport.
+ * Remote SDP might be needed as reference when application is in deciding
+ * side of negotiation (callee side), otherwise it should be NULL.
+ * This is just a simple wrapper which calls <tt>media_create()</tt> member 
+ * of the transport.
+ *
+ * @param tp            The media transport.
+ * @param pool          The memory pool.
+ * @param sdp_local     Local SDP.
+ * @param sdp_remote    Remote SDP.
+ *
+ * @return              PJ_SUCCESS on success, or the appropriate error code.
+ */
+PJ_INLINE(pj_status_t) pjmedia_transport_media_create(pjmedia_transport *tp,
+                                    pj_pool_t *pool,
+                                    pjmedia_sdp_session *sdp_local,
+                                    const pjmedia_sdp_session *sdp_remote)
+{
+    return (*tp->op->media_create)(tp, pool, sdp_local, sdp_remote);
+}
+
+/**
+ * Start the transport with regards to SDP negotiation result. 
+ * This is just a simple wrapper which calls <tt>media_start()</tt> member 
+ * of the transport.
+ *
+ * @param tp            The media transport.
+ * @param pool          The memory pool.
+ * @param sdp_local     Local SDP.
+ * @param sdp_remote    Remote SDP.
+ * @param media_index   Media index to start.
+ *
+ * @return              PJ_SUCCESS on success, or the appropriate error code.
+ */
+PJ_INLINE(pj_status_t) pjmedia_transport_media_start(pjmedia_transport *tp,
+                                    pj_pool_t *pool,
+                                    pjmedia_sdp_session *sdp_local,
+                                    const pjmedia_sdp_session *sdp_remote,
+                                    unsigned media_index)
+{
+    return (*tp->op->media_start)(tp, pool, sdp_local, sdp_remote, media_index);
+}
+
+
+/**
+ * Stop the transport. 
+ * This is just a simple wrapper which calls <tt>media_stop()</tt> member 
+ * of the transport.
+ *
+ * @param tp            The media transport.
+ *
+ * @return              PJ_SUCCESS on success, or the appropriate error code.
+ */
+PJ_INLINE(pj_status_t) pjmedia_transport_media_stop(pjmedia_transport *tp)
+{
+    return (*tp->op->media_stop)(tp);
+}
+
+/**
  * Close media transport. This is just a simple wrapper which calls 
  * <tt>destroy()</tt> member of the transport. This function will free
@@ -427 +530 @@
 }
 
+/**
+ * Simulate packet lost in the specified direction (for testing purposes).
+ * When enabled, the transport will randomly drop packets to the specified
+ * direction.
+ *
+ * @param tp        The media transport.
+ * @param dir       Media direction to which packets will be randomly dropped.
+ * @param pct_lost  Percent lost (0-100). Set to zero to disable packet
+ *                  lost simulation.
+ *
+ * @return          PJ_SUCCESS on success.
+ */
+PJ_INLINE(pj_status_t) pjmedia_transport_simulate_lost(pjmedia_transport *tp,
+                                                       pjmedia_dir dir,
+                                                       unsigned pct_lost)
+{
+    return (*tp->op->simulate_lost)(tp, dir, pct_lost);
+}
+
 
 PJ_END_DECL