Wiki Page Content

Differences between revisions 12 and 13
Revision 12 as of 2013-07-14 06:43:18
Size: 943
Editor: RainerDeyke
Comment: Fixed syntax error in code example.
Revision 13 as of 2013-08-08 05:24:06
Size: 1201
Editor: RyanGordon
Comment: Rewritten.
Deletions are marked like this. Additions are marked like this.
Line 17: Line 17:
Returns the name of the audio driver at the requested index.

<<Col
or2(green,What happens if it fails or there is no driver? Empty ""?)>>
Returns the name of the audio driver at the requested index, or NULL if an invalid index was specified.
Line 24: Line 22:
Line 29: Line 26:
Line 30: Line 28:
The list of audio drivers is given in the order that they are normally initialized by default. The list of audio drivers is given in the order that they are normally initialized by default; the drivers that seem more reasonable to choose first (as far as the SDL developers believe) are earlier in the list.

The names of drivers are all simple, low-ASCII identifiers, like "alsa", "coreaudio" or "xaudio2". These never have Unicode characters, and are not meant to be proper names.

SDL_GetAudioDriver

Use this function to get the name of a built in audio driver.

Syntax

const char* SDL_GetAudioDriver(int index)

Function Parameters

index

the index of the audio driver; the value ranges from 0 to SDL_GetNumAudioDrivers() - 1.

Return Value

Returns the name of the audio driver at the requested index, or NULL if an invalid index was specified.

Code Examples

int i;
for ( i = 0; i < SDL_GetNumAudioDrivers(); ++i ) {
    printf("Audio driver %d: %s\n", i, SDL_GetAudioDriver(i));
}

Remarks

The list of audio drivers is given in the order that they are normally initialized by default; the drivers that seem more reasonable to choose first (as far as the SDL developers believe) are earlier in the list.

The names of drivers are all simple, low-ASCII identifiers, like "alsa", "coreaudio" or "xaudio2". These never have Unicode characters, and are not meant to be proper names.


CategoryAPI, CategoryAudio

None: SDL_GetAudioDriver (last edited 2014-10-10 20:17:37 by PhilippWiesemann)

(Page Info.)
Feedback
Please include your contact information if you'd like to receive a reply.
Submit