midiOutReset 函式 (mmeapi.h)
midiOutReset函式會關閉指定 MIDI 輸出裝置之所有 MIDI 通道上的所有附注。
語法
MMRESULT midiOutReset(
HMIDIOUT hmo
);
參數
hmo
MIDI 輸出裝置的控制碼。 此參數也可以是將 MIDI 資料流程轉換成 HMIDIOUT的控制碼。
傳回值
如果成功或發生錯誤,則傳回MMSYSERR_NOERROR。 可能的錯誤值包括下列專案。
傳回碼 | 描述 |
---|---|
|
指定的裝置控制碼無效。 |
備註
任何擱置的系統獨佔或資料流程輸出緩衝區會傳回回回呼函式,而MHDR_DONE旗標是在MIDIHDR結構的dwFlags成員中設定。
終止系統獨佔訊息而不傳送 EOX (端獨佔) 位元組,可能會導致接收裝置發生問題。 midiOutReset函式在終止系統獨佔訊息時不會傳送 EOX 位元組 - 應用程式負責執行此動作。
若要關閉所有附注,會針對每個頻道中的每個附注傳送記事訊息。 此外,每個通道都會關閉持續控制器。
需求
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | mmeapi.h (包含 Windows.h) |
程式庫 | Winmm.lib |
Dll | Winmm.dll |