NAME

       al_play_audio_stream_f - Allegro 5 API

SYNOPSIS

              #include <allegro5/allegro_audio.h>

              ALLEGRO_AUDIO_STREAM *al_play_audio_stream_f(ALLEGRO_FILE *fp, const char *ident)

DESCRIPTION

       Loads and plays an audio file from ALLEGRO_FILE(3alleg5) stream as it is needed.

       The  file  type  is  determined  by  the  passed  `ident'  parameter, which is a file name
       extension including the leading dot.

       Returns the stream on success, NULL on failure.  You must not destroy the returned stream,
       it  will  be  automatically  destroyed  when  the addon is shut down.  On success the file
       should be considered owned by the audio stream, and will be closed when the  audio  stream
       is destroyed.  On failure the file will be closed.

              Note: the allegro_audio library does not support any audio file formats by default.
              You must use the allegro_acodec addon, or register your own format handler.

SEE ALSO

       al_play_audio_stream(3alleg5), al_load_audio_stream_f(3alleg5)

SINCE

       5.2.8

              [Unstable API]: New API.