jitter_buffer: added jitter_buffer_get_another()

git-svn-id: http://svn.xiph.org/trunk/speex@14075 0101bb08-14d6-0310-b084-bc0e0c8e3800

1 files changed, 9 insertions, 0 deletions

diff --git a/include/speex/speex_jitter.h b/include/speex/speex_jitter.h
index 6da807f..94395a7 100644
--- a/include/speex/speex_jitter.h
+++ b/include/speex/speex_jitter.h
@@ -134,10 +134,19 @@ void jitter_buffer_put(JitterBuffer *jitter, const JitterBufferPacket *packet);
  * 
  * @param jitter Jitter buffer state
  * @param packet Returned packet
+ * @param desired_span Number of samples (or units) we wish to get from the buffer (no guarantee)
  * @param current_timestamp Timestamp for the returned packet 
 */
 int jitter_buffer_get(JitterBuffer *jitter, JitterBufferPacket *packet, spx_int32_t desired_span, spx_int32_t *start_offset);
 
+/** Used right after jitter_buffer_get() to obtain another packet that would have the same timestamp.
+ * This is mainly useful for media where a single "frame" can be split into several packets.
+ * 
+ * @param jitter Jitter buffer state
+ * @param packet Returned packet
+ */
+int jitter_buffer_get_another(JitterBuffer *jitter, JitterBufferPacket *packet);
+
 /** Get pointer timestamp of jitter buffer
  * 
  * @param jitter Jitter buffer state