Обработка ошибок с помощью звуковых функций
[Функция, связанная с этой страницей, Waveform Audio, является устаревшей функцией. Он был заменен WASAPI и Audio Graphs. WasAPI и Audio Graphs оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует использовать в новом коде WASAPI и Звуковые графы вместо Waveform Audio, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, использующий устаревшие API, чтобы по возможности использовать новые API.]
Функции waveform-audio и вспомогательные функции возвращают ненулевое значение при возникновении ошибки. Windows предоставляет функции, которые преобразуют эти значения ошибок в текстовые описания ошибок. Приложение по-прежнему должно проверять значения ошибок, чтобы определить, как продолжить работу, но текстовые описания ошибок можно использовать в диалоговых окнах, описывающих ошибки для пользователей.
Для получения текстовых описаний значений звуковых ошибок можно использовать следующие функции:
Функция | Описание |
---|---|
waveInGetErrorText | Извлекает текстовое описание указанной ошибки ввода волны и аудио. |
waveOutGetErrorText | Извлекает текстовое описание указанной ошибки вывода waveform-audio. |
Единственными звуковыми функциями, которые не возвращают значения ошибок, являются auxGetNumDevs, waveInGetNumDevs и waveOutGetNumDevs. Эти функции возвращают ноль, если в системе нет устройств или если в них возникают ошибки.