midiOutReset 函式 (mmeapi.h)

midiOutReset函式會關閉指定 MIDI 輸出裝置之所有 MIDI 通道上的所有附注。

語法

MMRESULT midiOutReset(
  HMIDIOUT hmo
);

hmo

MIDI 輸出裝置的控制碼。此參數也可以是將 MIDI 資料流程轉換成 HMIDIOUT的控制碼。

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

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

任何擱置的系統獨佔或資料流程輸出緩衝區會傳回回回呼函式，而MHDR_DONE旗標是在MIDIHDR結構的dwFlags成員中設定。

終止系統獨佔訊息而不傳送 EOX (端獨佔) 位元組，可能會導致接收裝置發生問題。 midiOutReset函式在終止系統獨佔訊息時不會傳送 EOX 位元組 - 應用程式負責執行此動作。

若要關閉所有附注，會針對每個頻道中的每個附注傳送記事訊息。此外，每個通道都會關閉持續控制器。


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