Tratamento de erros com funções de áudio

[O recurso associado a esta página, Waveform Audio, é um recurso herdado. Ele foi substituído por WASAPI e Audio Graphs. WASAPI e Audio Graphs foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use WASAPI e Audio Graphs em vez de Waveform Audio, quando 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:

Função	Descrição
waveInGetErrorText	Recupera uma descrição textual de um erro de entrada de áudio de forma de onda especificado.
waveOutGetErrorText	Recupera uma descrição textual de um erro de saída de áudio de forma de onda especificado.

 

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