Поделиться через

Функция midiInGetErrorText (mmeapi.h)

  • Статья

Функция midiInGetErrorText извлекает текстовое описание ошибки, определяемой указанным кодом ошибки.

Синтаксис

MMRESULT midiInGetErrorText(
  MMRESULT mmrError,
  LPSTR    pszText,
  UINT     cchText
);

Параметры

mmrError

Код ошибки.

pszText

Указатель на буфер для заполнения текстовым описанием ошибки.

cchText

Длина (в символах) буфера, на который указывает lpText.

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

Возвращает MMSYSERR_NOERROR в случае успешного выполнения или ошибку в противном случае. Возможные значения ошибок:

Код возврата Описание
MMSYSERR_BADERRNUM
 Указанный номер ошибки выходит за пределы диапазона.
MMSYSERR_INVALPARAM
 Указанный указатель или структура недопустимы.
MMSYSERR_NOMEM
 Системе не удается выделить или заблокировать память.

Комментарии

Если текстовое описание ошибки длиннее указанного буфера, описание усекается. Возвращаемая строка ошибки всегда заканчивается null. Если cchText равно нулю, ничего не копируется, а функция возвращает ноль. Все описания ошибок меньше, чем длина символов MAXERRORLENGTH.

Требования

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header mmeapi.h (включая Windows.h)
Библиотека Winmm.lib
DLL Winmm.dll

См. также раздел

Функции MIDI