#pragma section-numbers off
#pragma disable-camelcase

= SDL_AudioInit =
Use this function to initialize a particular audio driver.

<<TableOfContents()>>

== Syntax ==
{{{#!highlight cpp
int SDL_AudioInit(const char* driver_name)
}}}

== Function Parameters ==
||'''driver_name'''||the name of the desired audio driver||

== Return Value ==
Returns 0 on success or a negative error code on failure; call [[SDL_GetError]]() for more information.

== Code Examples ==
{{{#!highlight cpp
int i;

for (i = 0; i < SDL_GetNumAudioDrivers(); ++i) {
    const char* driver_name = SDL_GetAudioDriver(i);
    if (SDL_AudioInit(driver_name)) {
        printf("Audio driver failed to initialize: %s\n", driver_name);
        continue;
    }
    SDL_AudioQuit();
}
}}}

== Remarks ==
This function is used internally, and should not be used unless you have a specific need to designate the audio driver you want to use.  You should normally use [[SDL_Init]]() or [[SDL_InitSubSystem]]().

== Related Functions ==
 .[[SDL_AudioQuit]]

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