Share via

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

  • Статья

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

Синтаксис

MMRESULT midiInGetErrorTextW(
  MMRESULT mmrError,
  LPWSTR   pszText,
  UINT     cchText
);

Параметры

mmrError

Код ошибки.

pszText

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

cchText

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

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

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

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

Комментарии

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

Примечание

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

Требования

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

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

Функции MIDI