Función SDL_OpenAudio

Sintaxis

int SDL_OpenAudio(SDL_AudioSpec * desired,
                  SDL_AudioSpec * obtained);

Descripción

Esta función es un medio heredado para abrir el dispositivo de audio.

Parámetros

desired

Una estructura SDL_AudioSpec que representa el formato de salida deseado. Por favor, consultar la documentación SDL_AudioSpec para más detalles sobre cómo preparar esta estructura.

obtained

Una estructura SDL_AudioSpec rellenada con los parámetros reales, o NULL.

Valor de retorno

Devuelve 0 si tiene éxito, colocando los parámetros de hardware reales en la estructura apuntada por obtained.

Si obtained es NULL, se garantiza que los datos de audio pasados a la función de retrollamada están en el formato solicitado, y se convertirán automáticamente al formato de audio de hardware real si es necesario. Si obtained es NULL, desired tendrá los campos modificados.

Esta función devuelve un código de error negativo en caso de fallo al abrir el dispositivo de audio o al configurar el hilo de audio. Ver SDL_GetError.

Observaciones

Esta función se mantiene por compatibilidad con SDL 1.2, pero también porque es ligeramente más fácil de usar que las nuevas funciones de SDL 2.0. La nueva, más potente y preferida forma de hacerlo es SDL_OpenAudioDevice().

Esta función es aproximadamente equivalente a:

SDL_OpenAudioDevice(NULL, 0, desired, obtained, SDL_AUDIO_ALLOW_ANY_CHANGE);

Con dos excepciones notables:

Si obtained es NULL, se usará desired (y no se permiten cambios), lo que significa que desired se modificará para tener los valores correctos para silence, etc, y SDL convertirá cualquier diferencia entre la petición específica de la app y el hardware entre bastidores.

El valor de retorno es siempre éxito o fracaso, y no un ID de dispositivo, lo que significa que solo se puede tener un dispositivo abierto a la vez con esta función.