midiInStart 函数 (mmeapi.h)

  • 项目

midiInStart 函数在指定的 MIDI 输入设备上启动 MIDI 输入。

语法

MMRESULT midiInStart(
  HMIDIIN hmi
);

parameters

hmi

MIDI 输入设备的句柄。

返回值

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

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

注解

此函数将时间戳重置为零;后续收到的消息的时间戳值与调用此函数的时间相关。

除系统独占消息之外的所有消息在收到时都会直接发送到客户端。 系统独占消息放置在 midiInAddBuffer 函数提供的缓冲区中。 如果队列中没有缓冲区，系统独占数据会在不通知客户端的情况下被丢弃，并且继续输入。 缓冲区已满、收到完整的系统独占消息或使用 midiInReset 函数时，会返回到客户端。 MIDIHDR 结构的 dwBytesRecorded 成员将包含接收的数据的实际长度。

在输入已启动时调用此函数不起作用，并且函数返回零。

要求

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

另请参阅

MIDI 函数