Changeset 3461 for pjproject/branches/projects/2.0-dev/pjmedia/include/pjmedia/vid_stream.h

Timestamp:

Mar 17, 2011 11:33:34 AM (13 years ago)

Author:

bennylp

Message:

Re #1215 (framework):

• vstream:
  • allow NULL pool parameter which means vstream will create one
  • Updated remote FPS detection to only be performed if decoder returns frame (however the FPS detection is currently disabled as some endpoints changes fps continuously, causing renderer restart continuously too).
• codec:
  • Updated video codec info to have RTP packetization support flag, also update endpoint in generating SDP to only include codecs whose RTP packetization support.
  • Added dynamic payload types for video codecs.
  • (minor) separate video PT into separate enum in pjmedia-codec/types.h
• H264 initial experiment.

generated frames (for libx264 sake).

• Replaced PJ_EUNKNOWN in some places with the appropriate error code.

File:

• pjproject/branches/projects/2.0-dev/pjmedia/include/pjmedia/vid_stream.h (modified) (2 diffs)

pjproject/branches/projects/2.0-dev/pjmedia/include/pjmedia/vid_stream.h

@@ -160 +160 @@
  *
  * @param endpt         Media endpoint.
- * @param pool          Pool to allocate memory for the stream. A large
- *                      number of memory may be needed because jitter
+ * @param pool          Optional pool to allocate memory for the stream. If
+ *                      this is not specified, one will be created internally.
+ *                      A large number of memory may be needed because jitter
  *                      buffer needs to preallocate some storage.
- * @param info          Stream information.
- * @param tp            Stream transport instance used to transmit 
- *                      and receive RTP/RTCP packets to/from the underlying 
- *                      transport. 
+ * @param info          Stream information to create the stream. Upon return,
+ *                      this info will be updated with the information from
+ *                      the instantiated codec. Note that if the "pool"
+ *                      argument is NULL, some fields in this "info" parameter
+ *                      will be allocated from the internal pool of the
+ *                      stream, which means that they will only remain valid
+ *                      as long as the stream is not destroyed.
+ * @param tp            Media transport instance used to transmit and receive
+ *                      RTP/RTCP packets to/from the underlying network.
  * @param user_data     Arbitrary user data (for future callback feature).
  * @param p_stream      Pointer to receive the video stream.
@@ -175 +181 @@
                                         pjmedia_endpt *endpt,
                                         pj_pool_t *pool,
-                                        const pjmedia_vid_stream_info *info,
+                                        pjmedia_vid_stream_info *info,
                                         pjmedia_transport *tp,
                                         void *user_data,