Provided by: allegro4-doc_4.4.2-13_all bug

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(3alleg4)