Share via

midiInGetErrorTextW 函数 (mmeapi.h)

  • 项目

midiInGetErrorText 函数检索由指定错误代码标识的错误的文本说明。

语法

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

parameters

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 [仅限桌面应用]
目标平台 Windows
标头 mmeapi.h (包括 Windows.h)
Library Winmm.lib
DLL Winmm.dll

另请参阅

MIDI 函数