Обработка ошибок с помощью звуковых функций

[Функция, связанная с этой страницей, Waveform Audio, является устаревшей функцией. Он был заменен WASAPI и звуковых графов. WASAPI и Звуковые графы оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует, когда это возможно, использовать в новом коде WASAPI и Audio Graphs, вместо Waveform Audio. Корпорация Майкрософт предлагает, что существующий код, использующий устаревшие API, будет перезаписан для использования новых API, если это возможно.]

Функции waveform-audio и вспомогательные звуковые функции возвращают ненулевое значение при возникновении ошибки. Windows предоставляет функции, которые преобразуют эти значения ошибок в текстовые описания ошибок. Приложение должно по-прежнему проверять значения ошибок, чтобы определить, как продолжить, но текстовое описание ошибок можно использовать в диалоговых окнах, описывающих ошибки пользователям.

Для получения текстовых описаний значений звуковых ошибок можно использовать следующие функции:

Функция	Описание
waveInGetErrorText	Извлекает текстовое описание указанной ошибки ввода аудиосигнала.
waveOutGetErrorText	Извлекает текстовое описание указанной ошибки вывода волнового звука.

 

Единственными звуковыми функциями, которые не возвращают значения ошибок, являются auxGetNumDevs, waveInGetNumDevsи waveOutGetNumDevs. Эти функции возвращают ноль, если устройства отсутствуют в системе или возникают какие-либо ошибки.