Blast-Radius Aware AI Code Review for Business-Critical Systems
LiveReview LiveReview Explore LiveReview

SDL_GetAudioPlaybackDevices - Get a list of currently-connected audio playback devices.

Availability

       This function is available since SDL 3.2.0.

Description

       This  returns of list of available devices that play sound, perhaps to speakers or headphones ("playback"
       devices). If you want devices that record audio, like a microphone ("recording" devices), use

       SDL_GetAudioRecordingDevices () instead.

       This  only  returns  a  list  of  physical  devices;  it  will  not  have  any  device  IDs  returned  by
       SDL_OpenAudioDevice ().

       If this function returns NULL, to signify an error, *count will be set to zero.

Function Parameters

count  a pointer filled in with the number of devices returned, may be NULL.

Header File

       Defined in SDL3/SDL_audio.h

Name

       SDL_GetAudioPlaybackDevices - Get a list of currently-connected audio playback devices.

Return Value

       ( SDL_AudioDeviceID
        *)  Returns  a 0 terminated array of device instance IDs or NULL on error; call SDL_GetError () for more
       information. This should be freed with SDL_free () when it is no longer needed.

See Also

(3), SDL_OpenAudioDevice(3), (3), SDL_GetAudioRecordingDevices(3)

Simple Directmedia Layer                           SDL 3.2.10                     SDL_GetAudioPlaybackDevices(3)

Synopsis

#include"SDL3/SDL.h"SDL_AudioDeviceID*SDL_GetAudioPlaybackDevices(int*count);

Thread Safety

       It is safe to call this function from any thread.

See Also