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

Статья
11/20/2024

Функция 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 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	mmeapi.h (включая Windows.h)
библиотеки	Winmm.lib
DLL	Winmm.dll

См. также

функции MIDI

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