midiInStart 函数 (mmeapi.h)
midiInStart 函数在指定的 MIDI 输入设备上启动 MIDI 输入。
语法
MMRESULT midiInStart(
HMIDIIN hmi
);
parameters
hmi
MIDI 输入设备的句柄。
返回值
如果成功，则返回MMSYSERR_NOERROR，否则返回错误。 可能的错误值包括以下
| 返回代码 | 说明 |
|---|---|
|
指定的设备句柄无效。 |
注解
此函数将时间戳重置为零;后续收到的消息的时间戳值与调用此函数的时间相关。
除系统独占消息之外的所有消息在收到时都会直接发送到客户端。 系统独占消息放置在 midiInAddBuffer 函数提供的缓冲区中。 如果队列中没有缓冲区，系统独占数据会在不通知客户端的情况下被丢弃，并且继续输入。 缓冲区已满、收到完整的系统独占消息或使用 midiInReset 函数时，会返回到客户端。 MIDIHDR 结构的 dwBytesRecorded 成员将包含接收的数据的实际长度。
在输入已启动时调用此函数不起作用，并且函数返回零。
要求
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | mmeapi.h (包括 Windows.h) |
| Library | Winmm.lib |
| DLL | Winmm.dll |