midiOutReset 関数 (mmeapi.h)

midiOutReset 関数は、指定された MIDI 出力デバイスのすべての MIDI チャンネルのすべてのノートをオフにします。

構文

MMRESULT midiOutReset(
  HMIDIOUT hmo
);

hmo

MIDI 出力デバイスにハンドルします。このパラメーターは、 HMIDIOUT にキャストされた MIDI ストリームのハンドルにすることもできます。

成功した場合はMMSYSERR_NOERRORを返し、それ以外の場合はエラーを返します。考えられるエラー値は次のとおりです。

リターンコード	説明
MMSYSERR_INVALHANDLE	指定されたデバイスハンドルが無効です。

保留中のシステム排他またはストリーム出力バッファーはすべてコールバック関数に返され、MHDR_DONE フラグは MIDIHDR 構造体の dwFlags メンバーに設定されます。

EOX (排他終了) バイトを送信せずにシステム排他メッセージを終了すると、受信側デバイスに問題が発生する可能性があります。 midiOutReset 関数は、システム排他メッセージを終了するときに EOX バイトを送信しません。アプリケーションはこれを行う必要があります。

すべてのノートをオフにするには、各チャネルの各ノートのノートオフメッセージが送信されます。さらに、チャンネルごとにサステインコントローラーがオフになっています。


サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	mmeapi.h (Windows.h を含む)
Library	Winmm.lib
[DLL]	Winmm.dll