функция midiInGetErrorTextA (mmeapi.h)

Статья
11/20/2024

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

Синтаксис

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

Параметры

mmrError

Код ошибки.

pszText

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

cchText

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

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

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

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

Замечания

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

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	mmeapi.h (включая Windows.h)
библиотеки	Winmm.lib
DLL	Winmm.dll

См. также

функции MIDI

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