NAME

       SDL_BindAudioStreams - Bind a list of audio streams to an audio device.

SYNOPSIS

       #include <SDL3/SDL_audio.h>

       bool SDL_BindAudioStreams(SDL_AudioDeviceID devid, SDL_AudioStream * const *streams, int num_streams);

DESCRIPTION

       Audio data will flow through any bound streams. For a playback device, data for all bound streams will be
       mixed together and fed to the device. For a recording device, a copy of recorded data will be provided to
       each bound stream.

       Audio  streams  can  only  be bound to an open device. This operation is atomic--all streams bound in the
       same call will start processing at the same time, so they can stay in sync. Also: either all streams will
       be bound or none of them will be.

       It is an error to bind an already-bound stream; it must be explicitly unbound first.

       Binding a stream to a device will set its output format for playback devices, and its  input  format  for
       recording  devices, so they match the device's settings. The caller is welcome to change the other end of
       the stream's format at any time with SDL_SetAudioStreamFormat().  If the other end of the stream's format
       has never been set (the audio stream was created with a NULL audio spec), this function will  set  it  to
       match the device end's format.

FUNCTION PARAMETERS

       devid  an audio device to bind a stream to.

       streams
              an array of audio streams to bind.

       num_streams
              number streams listed in the streams array.

RETURN VALUE

       for more information.

THREAD SAFETY

       It is safe to call this function from any thread.

AVAILABILITY

       This function is available since SDL 3.2.0.

SEE ALSO

       SDL_BindAudioStreams(3), SDL_UnbindAudioStream(3), SDL_GetAudioStreamDevice(3)

Simple Directmedia Layer                           SDL 3.2.28                            SDL_BindAudioStreams(3)