NAME

       al_get_audio_stream_fragment - Allegro 5 API

SYNOPSIS

              #include <allegro5/allegro_audio.h>

              void *al_get_audio_stream_fragment(const ALLEGRO_AUDIO_STREAM *stream)

DESCRIPTION

       When  using Allegro’s audio streaming, you will use this function to continuously provide new sample data
       to a stream.

       If the stream is ready for new data, the function will return the address of an  internal  buffer  to  be
       filled  with  audio  data.   The  length  and  format  of  the  buffer  are  specified with al_create_au‐
       dio_stream(3alleg5) or can be queried with the various functions described  here.   Once  the  buffer  is
       filled, you must signal this to Allegro by passing the buffer to al_set_audio_stream_fragment(3alleg5).

       If the stream is not ready for new data, the function will return NULL.

              Note:  If  you  listen  to events from the stream, an ALLEGRO_EVENT_AUDIO_STREAM_FRAGMENT(3alleg5)
              event will be generated whenever a new fragment is ready.  However, getting  an  event  is  not  a
              guarantee that al_get_audio_stream_fragment(3alleg5) will not return NULL, so you still must check
              for it.

SEE ALSO

       al_set_audio_stream_fragment(3alleg5),        al_get_audio_stream_event_source(3alleg5),       al_get_au‐
       dio_stream_frequency(3alleg5), al_get_audio_stream_channels(3alleg5), al_get_audio_stream_depth(3alleg5),
       al_get_audio_stream_length(3alleg5)

Allegro reference manual                                                   al_get_audio_stream_fragment(3alleg5)