---
name: "al_load_audio_stream_f"
section: "3"
platform: "linux"
package: "allegro"
version: "5.2.11.3-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/al_load_audio_stream_f"
---

# al\_load\_audio\_stream\_f(3)

Allegro 5 API

## NAME

al\_load\_audio\_stream\_f - Allegro 5 API

## SYNOPSIS

-

  ```
  #include <allegro5/allegro_audio.h>
  ALLEGRO_AUDIO_STREAM *al_load_audio_stream_f(ALLEGRO_FILE* fp, const char *ident,
     size_t buffer_count, unsigned int samples)
  ```

## DESCRIPTION

Loads an audio file from [ALLEGRO\_FILE(3)](/ALLEGRO_FILE/3.md) stream as it is needed.

Unlike regular streams, the one returned by this function need not be fed by the user; the library will automatically read more of the file as it is needed. The stream will contain *buffer\_count* buffers with *samples* samples.

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

The audio stream will start in the playing state. It should be attached to a voice or mixer to generate any output. See [ALLEGRO\_AUDIO\_STREAM(3)](/ALLEGRO_AUDIO_STREAM/3.md) for more details.

Returns the stream on success, NULL on failure. 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\_load\_audio\_stream(3)](/al_load_audio_stream/3.md), [al\_register\_audio\_stream\_loader\_f(3)](/al_register_audio_stream_loader_f/3.md), [al\_init\_acodec\_addon(3)](/al_init_acodec_addon/3.md)