通过

midiInGetErrorTextA 函数 （mmeapi.h）

  • 项目

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 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows 2000 Professional [仅限桌面应用]
支持的最低服务器 Windows 2000 Server [仅限桌面应用]
目标平台 窗户
标头 mmeapi.h （包括 Windows.h）
库 Winmm.lib
DLL Winmm.dll

另请参阅

MIDI 函数