Share via

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

  • Статья

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

Синтаксис

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

Параметры

mmrError

Код ошибки.

pszText

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

cchText

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

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

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

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

Комментарии

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

Примечание

Заголовок mmeapi.h определяет midiOutGetErrorText в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

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

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

Функции MIDI