midiOutReset 函数 (mmeapi.h)

midiOutReset 函数关闭指定 MIDI 输出设备的所有 MIDI 通道上的所有注释。

语法

MMRESULT midiOutReset(
  HMIDIOUT hmo
);

parameters

hmo

MIDI 输出设备的句柄。 此参数也可以是将 MIDI 流强制转换为 HMIDIOUT 的句柄。

返回值

如果成功,则返回MMSYSERR_NOERROR,否则返回错误。 可能的错误值包括以下内容。

返回代码 说明
MMSYSERR_INVALHANDLE
指定的设备句柄无效。

注解

任何挂起的系统独占或流输出缓冲区都返回到回调函数,并在 MIDIHDR 结构的 dwFlags 成员中设置MHDR_DONE标志。

终止系统独占消息而不发送 EOX (独占结束) 字节可能会导致接收设备出现问题。 midiOutReset 函数在终止系统独占消息时不发送 EOX 字节 - 应用程序负责执行此操作。

若要关闭所有笔记,将为每个频道中的每个笔记发送一条笔记关闭消息。 此外,每个通道的维持控制器都处于关闭状态。

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 mmeapi.h (包括 Windows.h)
Library Winmm.lib
DLL Winmm.dll

另请参阅

MIDI 函数