SDL Wiki
(This is the documentation for SDL3, which is under heavy development and the API is changing! SDL2 is the current stable version!)


Get the human-readable name of a specific audio device.


char* SDL_GetAudioDeviceName(SDL_AudioDeviceID devid);

Function Parameters

devid the instance ID of the device to query.

Return Value

Returns the name of the audio device, or NULL on error.


The string returned by this function is UTF-8 encoded. The caller should call SDL_free on the return value when done with it.

Thread Safety

It is safe to call this function from any thread.


This function is available since SDL 3.0.0.

Code Examples

int i, count = SDL_GetNumAudioDevices(0);

for (i = 0; i < count; ++i) {
    SDL_Log("Audio device %d: %s", i, SDL_GetAudioDeviceName(i, 0));

CategoryAPI, CategoryAudio

[ edit | delete | history | feedback | raw ]

[ front page | index | search | recent changes | git repo | offline html ]

All wiki content is licensed under Creative Commons Attribution 4.0 International (CC BY 4.0).
Wiki powered by ghwikipp.