#pragma section-numbers off
#pragma disable-camelcase

= SDL_CloseAudioDevice =
Use this function to shut down audio processing and close the audio device.

<<TableOfContents()>>

== Syntax ==
{{{#!highlight cpp
void SDL_CloseAudioDevice(SDL_AudioDeviceID dev)
}}}

== Function Parameters ==
||'''dev'''||an audio device previously opened with [[SDL_OpenAudioDevice]]()||

== Code Examples ==
{{{#!highlight cpp
extern SDL_AudioSpec want;
SDL_AudioDeviceID devid = SDL_OpenAudioDevice(NULL, 0, &want, NULL, 0);
if (devid > 0) {
    SDL_PauseAudioDevice(devid, 0);
    SDL_Delay(5000);  // let audio callback run for 5 seconds.
    SDL_CloseAudioDevice(devid);
}
}}}

== Remarks ==
The application should close open audio devices once they are no longer needed. Calling this function will wait until the device's audio callback is not running, release the audio hardware and then clean up internal state. No further audio will play from this device once this function returns.

The device ID is invalid as soon as the device is closed, and is eligible for reuse in a new [[SDL_OpenAudioDevice]]() call immediately.

== Related Functions ==
 .[[SDL_OpenAudioDevice]]

----
[[CategoryAPI]], [[CategoryAudio]]