midiConnect 函式 (mmeapi.h)
midiConnect函式會將 MIDI 輸入裝置連接到 MIDI,或將 MIDI 連接到 MIDI 輸出裝置,或將 MIDI 連接到 MIDI 輸出裝置。
語法
MMRESULT midiConnect(
HMIDI hmi,
HMIDIOUT hmo,
LPVOID pReserved
);
參數
hmi
處理 MIDI 輸入裝置或 MIDI 到裝置。 (針對裝置,此控制碼必須由 midiOutOpen 函式的呼叫傳回。)
hmo
MIDI 輸出或裝置的控制碼。
pReserved
保留;必須是 Null。
傳回值
如果成功或發生錯誤,則傳回MMSYSERR_NOERROR。 可能的錯誤值包括下列專案。
傳回碼 | 描述 |
---|---|
|
指定的輸入裝置已連線到輸出裝置。 |
|
指定的裝置控制碼無效。 |
備註
呼叫此函式之後,當具有相同事件資料的訊息傳送至輸出裝置磁碟機時,MIDI 輸入裝置會在MIM_DATA訊息中接收事件資料。
第一個驅動程式是 MIDI 輸出驅動程式的特殊形式。 系統只允許一個 MIDI 輸出裝置連線到 MIDI 輸入裝置,但多個 MIDI 輸出裝置可以透過裝置連線到 MIDI。 每當指定的 MIDI 輸入裝置在MIM_DATA訊息中收到事件資料時,就會將具有相同事件資料的訊息傳送至指定的輸出裝置磁碟機 (或透過該驅動程式傳送至輸出驅動程式) 。
需求
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | mmeapi.h (包含 Windows.h) |
程式庫 | Winmm.lib |
Dll | Winmm.dll |