Added explanation about how audio callback works

2 files changed, 7 insertions, 3 deletions

diff --git a/other/apidsl/toxav.in.h b/other/apidsl/toxav.in.h
index 59a46612..6e50d0d5 100644
--- a/other/apidsl/toxav.in.h
+++ b/other/apidsl/toxav.in.h
@@ -578,8 +578,10 @@ namespace video {
 namespace audio {
   event receive_frame {
     /**
-     * The function type for the ${event receive_frame} callback.
-     *
+     * The function type for the ${event receive_frame} callback. The callback can be
+     * called multiple times per single iteration depending on the amount of queued
+     * frames in the buffer.
+     * 
      * @param friend_number The friend number of the friend who sent an audio frame.
      * @param pcm An array of audio samples (sample_count * channels elements).
      * @param sample_count The number of audio samples per channel in the PCM array.
diff --git a/toxav/toxav.h b/toxav/toxav.h
index 2094f66c..917a6bf5 100644
--- a/toxav/toxav.h
+++ b/toxav/toxav.h
@@ -592,7 +592,9 @@ bool toxav_video_send_frame(ToxAV *toxAV, uint32_t friend_number, uint16_t width
  *
  ******************************************************************************/
 /**
- * The function type for the audio_receive_frame callback.
+ * The function type for the audio_receive_frame callback. The callback can be
+ * called multiple times per single iteration depending on the amount of queued
+ * frames in the buffer.
  *
  * @param friend_number The friend number of the friend who sent an audio frame.
  * @param pcm An array of audio samples (sample_count * channels elements).