Control de errores con funciones de audio

[La característica asociada a esta página, Waveform Audio, es una característica heredada. Se ha reemplazado por WASAPI y Audio Graphs. WASAPI y Audio Graphs se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use WASAPI y Audio Graphs en lugar de Waveform Audio, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

Las funciones waveform-audio y auxiliar-audio devuelven un valor distinto de cero cuando se produce un error. Windows proporciona funciones que convierten estos valores de error en descripciones textuales de los errores. La aplicación todavía debe examinar los valores de error para determinar cómo continuar, pero se pueden usar descripciones textuales de errores en cuadros de diálogo que describen los errores a los usuarios.

Puede usar las siguientes funciones para recuperar descripciones textuales de los valores de error de audio:

Función	Descripción
waveInGetErrorText	Recupera una descripción textual de un error de entrada de audio de forma de onda especificado.
waveOutGetErrorText	Recupera una descripción textual de un error de salida de audio de forma de onda especificado.

 

Las únicas funciones de audio que no devuelven valores de error son auxGetNumDevs, waveInGetNumDevs y waveOutGetNumDevs. Estas funciones devuelven cero si no hay ningún dispositivo presente en un sistema o si se producen errores.