Changeset 5803 for pjproject/trunk/pjmedia/include/pjmedia/jbuf.h

Timestamp:

Jun 6, 2018 8:38:29 AM (6 years ago)

Author:

nanang

Message:

Fixed #2118:

• Stream buffer calculation is now based on maximum bitrate and maximum receiving frame size.
• Added buffer size check when getting frame from jitter buffer, pjmedia_jbuf_get_frame*() specification has been updated that 'size' param is now input and output (was output only).

File:

• pjproject/trunk/pjmedia/include/pjmedia/jbuf.h (modified) (5 diffs)

pjproject/trunk/pjmedia/include/pjmedia/jbuf.h

@@ -282 +282 @@
  * @param bit_info      Bit precise info of the frame, e.g: a frame may not 
  *                      exactly start and end at the octet boundary, so this
- *                      field may be used for specifying start & end bit offset.
+ *                      field may be used for specifying start & end bit
+ *                      offset.
  * @param frame_seq     The frame sequence number.
  * @param discarded     Flag whether the frame is discarded by jitter buffer.
@@ -307 +308 @@
  * @param bit_info      Bit precise info of the frame, e.g: a frame may not 
  *                      exactly start and end at the octet boundary, so this
- *                      field may be used for specifying start & end bit offset.
+ *                      field may be used for specifying start & end bit
+ *                      offset.
  * @param frame_seq     The frame sequence number.
  * @param frame_ts      The frame timestamp.
@@ -355 +357 @@
  * @param frame         Buffer to receive the payload from the jitter buffer.
  *                      @see pjmedia_jbuf_get_frame().    
- * @param size          Pointer to receive frame size.
+ * @param size          On input, it points to maximum buffer length.
+ *                      On output, it will be filled with received frame size.
  * @param p_frm_type    Pointer to receive frame type.
  *                      @see pjmedia_jbuf_get_frame().    
  * @param bit_info      Bit precise info of the frame, e.g: a frame may not 
  *                      exactly start and end at the octet boundary, so this
- *                      field may be used for specifying start & end bit offset.
+ *                      field may be used for specifying start & end bit
+ *                      offset.
  */
 PJ_DECL(void) pjmedia_jbuf_get_frame2(pjmedia_jbuf *jb, 
@@ -376 +380 @@
  * @param frame         Buffer to receive the payload from the jitter buffer.
  *                      @see pjmedia_jbuf_get_frame().    
- * @param size          Pointer to receive frame size.
+ * @param size          On input, it points to maximum buffer length.
+ *                      On output, it will be filled with received frame size.
  * @param p_frm_type    Pointer to receive frame type.
  *                      @see pjmedia_jbuf_get_frame().    
  * @param bit_info      Bit precise info of the frame, e.g: a frame may not 
  *                      exactly start and end at the octet boundary, so this
- *                      field may be used for specifying start & end bit offset.
+ *                      field may be used for specifying start & end bit
+ *                      offset.
  * @param ts            Frame timestamp.
  * @param seq           Frame sequence number.
@@ -407 +413 @@
  * @param bit_info      Bit precise info of the frame, e.g: a frame may not 
  *                      exactly start and end at the octet boundary, so this
- *                      field may be used for specifying start & end bit offset.
+ *                      field may be used for specifying start & end bit
+ *                      offset.
  * @param ts            Frame timestamp.
  * @param seq           Frame sequence number.