Мультимедиа для Windows
5b239685

Текстовое описание ошибки


Когда мы рассказывали об использовании функции mciSendString , то упоминали функцию mciGetErrorString, с помощью которой можно преобразовать код ошибки в текстовое описание в виде строки символов. Аналогичная возможность есть и у приложений, работающих со звуковым адаптером на низком уровне. Для выполнения такого преобразования приложение может воспользоваться функцией waveInGetErrorText (для устройства ввода) и waveOutGetErrorText (для устройства вывода).

Приведем описание функции waveInGetErrorText:

Функция waveInGetErrorText

UINT waveInGetErrorText( UINT wError, // код ошибки LPSTR lpstrBuffer, // буфер для записи текстовой строки UINT wLength); // размер буфера

Параметры функции:

wError

Код ошибки, полученный от функций низкого уровня

lpstrBuffer

Буфер, в который будет записано текстовое описание ошибки

wLength

Размер буфера в байтах. В файле mmsystem.h определена константа MAXERRORLENGTH , которая соответствует размеру самого длинного сообщения об ошибке

Возвращаемое значение:

Функция возвращает нулевое значение при успешном завершении или значение MMSYSERR_BADERRNUM , если переданному коду ошибки не соответствует ни одно текстовое описание

Функция waveOutGetErrorText используется аналогично функции waveInGetErrorText:

Функция waveOutGetErrorText

UINT waveOutGetErrorText( UINT wError, // код ошибки LPSTR lpstrBuffer, // буфер для записи текстовой строки UINT wLength); // размер буфера

Параметры функции:

Аналогичны параметрам функции waveInGetErrorText

Возвращаемое значение:

Аналогично функции waveInGetErrorText



Содержание раздела