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


Close a previously-opened audio device.

Header File

Defined in <SDL3/SDL_audio.h>


void SDL_CloseAudioDevice(SDL_AudioDeviceID devid);

Function Parameters

devid an audio device id previously returned by SDL_OpenAudioDevice()


The application should close open audio devices once they are no longer needed.

This function may block briefly while pending audio data is played by the hardware, so that applications don't drop the last buffer of data they supplied if terminating immediately afterwards.

Thread Safety

It is safe to call this function from any thread.


This function is available since SDL 3.0.0.

Code Examples

extern SDL_AudioSpec want;
SDL_AudioDeviceID devid = SDL_OpenAudioDevice(SDL_AUDIO_DEVICE_DEFAULT_OUTPUT, &want);
if (devid != 0) {
    SDL_Delay(5000);  // let device play for 5 seconds

See Also

CategoryAPI, CategoryAPIFunction, 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.