midiInStart 函式 (mmeapi.h)
midiInStart函式會在指定的 MIDI 輸入裝置上啟動 MIDI 輸入。
語法
MMRESULT midiInStart(
HMIDIIN hmi
);
參數
hmi
MIDI 輸入裝置的控制碼。
傳回值
如果成功或發生錯誤，則傳回MMSYSERR_NOERROR。 可能的錯誤值包括下列專案
| 傳回碼 | 描述 |
|---|---|
|
指定的裝置控制碼無效。 |
備註
此函式會將時間戳記重設為零;後續接收之訊息的時間戳記值相對於呼叫此函式的時間。
系統專屬訊息以外的所有訊息都會在收到訊息時直接傳送至用戶端。 系統獨佔訊息會放在 midiInAddBuffer 函式所提供的緩衝區中。 如果佇列中沒有緩衝區，系統獨佔資料會擲回，而不會通知用戶端，而且輸入會繼續。 當緩衝區已滿、收到完整的系統獨佔訊息時，或是使用 midiInReset 函式時，緩衝區會傳回給用戶端。 MIDIHDR結構的dwBytesRecorded成員將包含所接收資料的實際長度。
當輸入已啟動時呼叫此函式沒有任何作用，而且函式會傳回零。
需求
| 最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | mmeapi.h (包含 Windows.h) |
| 程式庫 | Winmm.lib |
| Dll | Winmm.dll |