Función SDL_GetAudioDeviceName

Sintaxis

const char* SDL_GetAudioDeviceName(int index,
                                   int iscapture);

Descripción

Obtiene el nombre legible por humanos de un dispositivo de audio específico.

Parámetros

index

El índice del dispositivo de audio; los valores válidos van de 0 a SDL_GetNumAudioDevices() - 1.

iscapture

Distinto de cero para consultar la lista de dispositivos de grabación, cero para consultar la lista de dispositivos de salida.

Valor de retorno

Devuelve el nombre del dispositivo de audio en el índice solicitado, o NULL en caso de error.

Observaciones

Esta función sólo es válida después de inicializar con éxito el subsistema de audio. Los valores devueltos por esta función reflejan la última llamada a SDL_GetNumAudioDevices(); volver a llamar a esa función para volver a detectar el hardware disponible.

La cadena devuelta por esta función está codificada en UTF-8, es de sólo lectura y se gestiona internamente. No debe ser liberada. Si se necesita mantener la cadena durante algún tiempo, se debe hacer su propia copia de ella, ya que no será válida la próxima vez que se llame a cualquiera de las otras funciones SDL.