|
Size: 1471
Comment: returns NULL on error.
|
Size: 1465
Comment: Removed spaces in example and deactivated camel case.
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 2: | Line 2: |
| #pragma disable-camelcase | #pragma camelcase off |
| Line 26: | Line 26: |
| for ( i = 0; i < count; ++i ) { | for (i = 0; i < count; ++i) { |
SDL_GetAudioDeviceName
Use this function to get the name of a specific audio device.
Contents
Syntax
const char* SDL_GetAudioDeviceName(int index,
int iscapture)
Function Parameters
index |
the index of the audio device; the value ranges from 0 to 1 - SDL_GetNumAudioDevices() |
iscapture |
non-zero to specify a device that has recording capability |
Return Value
Returns the name of the audio device at the requested index, or NULL on error.
Code Examples
int i, count = SDL_GetNumAudioDevices(0);
for (i = 0; i < count; ++i) {
printf("Audio device %d: %s\n", i, SDL_GetAudioDeviceName(i, 0));
}
Remarks
This function is only valid after successfully initializing the audio subsystem. The values returned by this function reflect the latest call to SDL_GetNumAudioDevices(); re-call that function to re-detect available hardware.
The string returned by this function is UTF-8 encoded, read-only, and managed internally. You are not to free it. If you need to keep the string for any length of time, you should make your own copy of it, as it will be invalid next time any of several other SDL functions is called.
