midiInStart 函式 (mmeapi.h)

  • 發行項

midiInStart函式會在指定的 MIDI 輸入裝置上啟動 MIDI 輸入。

語法

MMRESULT midiInStart(
  HMIDIIN hmi
);

參數

hmi

MIDI 輸入裝置的控制碼。

傳回值

如果成功或發生錯誤，則傳回MMSYSERR_NOERROR。 可能的錯誤值包括下列專案

傳回碼 描述
MMSYSERR_INVALHANDLE
 指定的裝置控制碼無效。

備註

此函式會將時間戳記重設為零;後續接收之訊息的時間戳記值相對於呼叫此函式的時間。

系統專屬訊息以外的所有訊息都會在收到訊息時直接傳送至用戶端。 系統獨佔訊息會放在 midiInAddBuffer 函式所提供的緩衝區中。 如果佇列中沒有緩衝區，系統獨佔資料會擲回，而不會通知用戶端，而且輸入會繼續。 當緩衝區已滿、收到完整的系統獨佔訊息時，或是使用 midiInReset 函式時，緩衝區會傳回給用戶端。 MIDIHDR結構的dwBytesRecorded成員將包含所接收資料的實際長度。

當輸入已啟動時呼叫此函式沒有任何作用，而且函式會傳回零。

需求

   
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 mmeapi.h (包含 Windows.h)
程式庫 Winmm.lib
Dll Winmm.dll

另請參閱

MIDI 函式