read_sound_input(3)             Allegro manual             read_sound_input(3)



NAME
       read_sound_input - Retrieves the last recorded audio buffer. Allegro
       game programming library.

SYNOPSIS
       #include <allegro.h>


       int read_sound_input(void *buffer);

DESCRIPTION
       Retrieves the most recently recorded audio buffer into the specified
       location. The buffer size can be obtained by checking the return value
       from start_sound_input(). You must be sure to call this function at
       regular intervals during the recording (typically around 100 times a
       second), or some data will be lost. If you are unable to do this often
       enough from the mainline code, use the digi_recorder() callback to
       store the waveform into a larger buffer of your own.

       Note: many cards produce a click or popping sound when switching
       between record and playback modes, so it is often a good idea to
       discard the first buffer after you start a recording. The waveform is
       always stored in unsigned format, with stereo data consisting of
       alternate left/right samples.

RETURN VALUE
       The function will return non-zero if a buffer has been copied or zero
       if no new data is yet available (you were too fast checking the input).


SEE ALSO
       start_sound_input(3)



Allegro                          version 4.2.3             read_sound_input(3)
