Tratamento de erros com funções de áudio

[O recurso associado a esta página, Waveform Audio, é um recurso legado. Foi substituído por WASAPI e Audio Graphs. WASAPI e Audio Graphs foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda vivamente que o novo código utilize WASAPI e Audio Graphs em vez de Waveform Audio, sempre que possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

As funções waveform-audio e auxiliary-audio retornam um valor diferente de zero quando ocorre um erro. O Windows fornece funções que convertem esses valores de erro em descrições textuais dos erros. O aplicativo ainda deve examinar os valores de erro para determinar como proceder, mas descrições textuais de erros podem ser usadas em caixas de diálogo que descrevem erros para os usuários.

Você pode usar as seguintes funções para recuperar descrições textuais de valores de erro de áudio:

As únicas funções de áudio que não retornam valores de erro são auxGetNumDevs, waveInGetNumDevse waveOutGetNumDevs. Essas funções retornam zero se nenhum dispositivo estiver presente em um sistema ou se encontrarem erros.