Gestione degli errori con funzioni audio

[La funzionalità associata a questa pagina , Waveform Audio, è una funzionalità legacy. È stato sostituito da WASAPI e grafici audio. WasAPI e grafici audio sono stati ottimizzati per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi grafici WASAPI e Audio anziché Waveform Audio, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Le funzioni audio a forma d'onda e audio ausiliario restituiscono un valore diverso da zero quando si verifica un errore. Windows fornisce funzioni che convertono questi valori di errore in descrizioni testuali degli errori. L'applicazione deve comunque esaminare i valori di errore per determinare come procedere, ma le descrizioni testuali degli errori possono essere usate nelle finestre di dialogo che descrivono gli errori agli utenti.

È possibile usare le funzioni seguenti per recuperare descrizioni testuali dei valori di errore audio:

Le uniche funzioni audio che non restituiscono valori di errore sono auxGetNumDevs, waveInGetNumDevs e waveOutGetNumDevs. Queste funzioni restituiscono zero se nessun dispositivo è presente in un sistema o se si verificano errori.