Función SDL_GetNumAudioDevices
Sintaxis
int SDL_GetNumAudioDevices(int iscapture);
Descripción
Obtiene el número de dispositivos de audio incorporados.
Parámetros
- iscapture
- Cero para solicitar dispositivos de reproducción, distinto de cero para solicitar dispositivos de grabación.
Valor de retorno
Devuelve el número de dispositivos disponibles expuestos por el controlador actual o -1 si no se puede determinar una lista explícita de dispositivos. Un valor de retorno de -1 no significa necesariamente una condición de error.
Observaciones
Esta función sólo es válida después de inicializar con éxito el subsistema de audio.
Hay que tener en cuenta que el soporte de captura de audio no está implementado a partir de SDL 2.0.4, por lo que el parámetro iscapture es para futuras ampliaciones y siempre debe ser cero por ahora.
Esta función devolverá -1 si no se puede determinar una lista explícita de dispositivos. Devolver -1 no es un error. Por ejemplo, si SDL está configurado para hablar con un servidor de audio remoto, no puede listar todos los disponibles en Internet, pero aún así permitirá especificar un host específico en SDL_OpenAudioDevice().
En muchos casos comunes, cuando esta función devuelve un valor <= 0, todavía puede abrir con éxito el dispositivo por defecto (NULL para el primer argumento de SDL_OpenAudioDevice()).
Esta función puede desencadenar una completa redetección del hardware disponible. No debe ser llamada en cada iteración de un bucle, sino una vez al inicio del mismo:
// Don't do this: for (int i = 0; i < SDL_GetNumAudioDevices(0); i++) // do this instead: const int count = SDL_GetNumAudioDevices(0); for (int i = 0; i < count; ++i) { do_something_here(); }