Changeset 3664 for pjproject/trunk/pjmedia/include/pjmedia/endpoint.h

Timestamp:

Jul 19, 2011 3:42:28 AM (13 years ago)

Author:

nanang

Message:

Re #1326: Initial code integration from branch 2.0-dev to trunk as "2.0-pre-alpha-svn".

Location:

pjproject/trunk

Files:

• . (modified) (1 prop)
• pjmedia/include/pjmedia/endpoint.h (modified) (3 diffs)

pjproject/trunk/pjmedia/include/pjmedia/endpoint.h

@@ -40 +40 @@
 #include <pjmedia/codec.h>
 #include <pjmedia/sdp.h>
+#include <pjmedia/transport.h>
 
 
@@ -180 +181 @@
  *                      also denotes the maximum number of streams (i.e.
  *                      the "m=" lines) that will be created in the SDP.
+ *                      By convention, if this value is greater than one,
+ *                      the first media will be audio and the remaining
+ *                      media is video.
  * @param sock_info     Array of socket transport information. One 
  *                      transport is needed for each media stream, and
@@ -194 +198 @@
                                                pjmedia_sdp_session **p_sdp );
 
+/**
+ * Create a "blank" SDP session description. The SDP will contain basic SDP
+ * fields such as origin, time, and name, but without any media lines.
+ *
+ * @param endpt         The media endpoint.
+ * @param pool          Pool to allocate memory from.
+ * @param sess_name     Optional SDP session name, or NULL to use default
+ *                      value.
+ * @param origin        Address to put in the origin field.
+ * @param p_sdp         Pointer to receive the created SDP session.
+ *
+ * @return              PJ_SUCCESS on success, or the appropriate error code.
+ */
+PJ_DECL(pj_status_t) pjmedia_endpt_create_base_sdp(pjmedia_endpt *endpt,
+                                                   pj_pool_t *pool,
+                                                   const pj_str_t *sess_name,
+                                                   const pj_sockaddr *origin,
+                                                   pjmedia_sdp_session **p_sdp);
+
+/**
+ * Create SDP media line for audio media.
+ *
+ * @param endpt         The media endpoint.
+ * @param pool          Pool to allocate memory from.
+ * @param si            Socket information.
+ * @param options       Option flags, must be zero for now.
+ * @param p_m           Pointer to receive the created SDP media.
+ *
+ * @return              PJ_SUCCESS on success, or the appropriate error code.
+ */
+PJ_DECL(pj_status_t) pjmedia_endpt_create_audio_sdp(pjmedia_endpt *endpt,
+                                                    pj_pool_t *pool,
+                                                    const pjmedia_sock_info*si,
+                                                    unsigned options,
+                                                    pjmedia_sdp_media **p_m);
+
+/**
+ * Create SDP media line for video media.
+ *
+ * @param endpt         The media endpoint.
+ * @param pool          Pool to allocate memory from.
+ * @param si            Socket information.
+ * @param options       Option flags, must be zero for now.
+ * @param p_m           Pointer to receive the created SDP media.
+ *
+ * @return              PJ_SUCCESS on success, or the appropriate error code.
+ */
+PJ_DECL(pj_status_t) pjmedia_endpt_create_video_sdp(pjmedia_endpt *endpt,
+                                                    pj_pool_t *pool,
+                                                    const pjmedia_sock_info*si,
+                                                    unsigned options,
+                                                    pjmedia_sdp_media **p_m);
 
 /**