midiOutReset 函数 (mmeapi.h)

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

语法

MMRESULT midiOutReset(
  HMIDIOUT hmo
);

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