= SDL_GetAudioDeviceSpec =

Get the preferred audio format of a specific audio device.

== Syntax ==

<syntaxhighlight lang='c'>
int SDL_GetAudioDeviceSpec(int index,
                           int iscapture,
                           SDL_AudioSpec *spec);
</syntaxhighlight>

== Function Parameters ==

{|
|'''index'''
|the index of the audio device; valid values range from 0 to [[SDL_GetNumAudioDevices]]() - 1
|-
|'''iscapture'''
|non-zero to query the list of recording devices, zero to query the list of output devices.
|-
|'''spec'''
|The [[SDL_AudioSpec]] to be initialized by this function.
|}

== Return Value ==

Returns 0 on success, nonzero on error

== Remarks ==

This function is only valid after a successfully initializing the audio
subsystem. The values returned by this function reflect the latest call to
[[SDL_GetNumAudioDevices]](); re-call that function to redetect available
hardware.

<code>spec</code> will be filled with the sample rate, sample format, and
channel count.

== Version ==

This function is available since SDL 2.0.16.

== Related Functions ==

:[[SDL_GetNumAudioDevices]]
:[[SDL_GetDefaultAudioInfo]]

----
[[CategoryAPI]]