midiConnect 函数 (mmeapi.h)

  • 项目

midiConnect 函数通过 MIDI 或输出设备将 MIDI 输入设备连接到 MIDI，或者通过设备将 MIDI 连接到 MIDI 输出设备。

语法

MMRESULT midiConnect(
  HMIDI    hmi,
  HMIDIOUT hmo,
  LPVOID   pReserved
);

parameters

hmi

MIDI 输入设备的句柄或 MIDI 通过设备。 (对于通过的设备，此句柄必须已通过调用 midiOutOpen function.)

hmo

MIDI 输出或设备句柄。

pReserved

保留;必须为 NULL。

返回值

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

返回代码 说明
MIDIERR_NOTREADY
 指定的输入设备已连接到输出设备。
MMSYSERR_INVALHANDLE
 指定的设备句柄无效。

注解

调用此函数后，每当将具有相同事件数据的消息发送到输出设备驱动程序时，MIDI 输入设备将接收MIM_DATA消息中的事件数据。

通过的驱动程序是一种特殊形式的 MIDI 输出驱动程序。 系统仅允许一个 MIDI 输出设备连接到 MIDI 输入设备，但多个 MIDI 输出设备可以通过设备连接到 MIDI。 每当给定的 MIDI 输入设备在MIM_DATA消息中接收事件数据时，具有相同事件数据的消息将发送到给定的输出设备驱动程序 (或通过该驱动程序发送到输出驱动程序) 。

要求

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

另请参阅

MIDI 函数