midiOutReset

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

MMRESULT midiOutReset(
    HMIDIOUT hmo   // MIDI出力デバイスのハンドル
);

WINMM.DLL

引数

hmo

MIDI 出力デバイスのハンドルを指定します。 MIDI ストリームのハンドルを指定することもできます。

戻り値

関数が成功すると 0 (MMSYSERR_NOERROR) が返ります。

関数が失敗すると、以下のエラーが返ります。

値 意味
5 (MMSYSERR_INVALHANDLE)

指定されたハンドルは無効です。

解説

未処理のシステムエクスクルーシブおよびストリーム出力バッファはすべてコールバック関数に返されて、 MIDIHDR 構造体の dwFlags メンバには MHDR_DONE フラグがセットされます。

EOX バイトを送らずにシステムエクスクルーシブメッセージを終えると、受信デバイスに問題を引き起こす可能性があります。この関数は、システムエクスクルーシブメッセージを終えたときに EOX バイトを送信しません。したがって、アプリケーション自身が EOX バイトを送信しなければなりません。

この関数は、各チャンネルのそれぞれのノートに対してノートオフメッセージを送信して、すべてのノートをオフにします。

対応情報

Windows 95 以降 / Windows NT 3.1 以降