<Return[MN]><Top>

midiOutReset

Declare Function Api_midiOutReset& Lib "winmm" Alias "midiOutReset" (ByVal hmo&)

Declare Function midiOutReset Lib "winmm" (ByVal hmo As Long) As Long

指定された MIDI 出力デバイスに対するすべての MIDI チャネルの音符(ノート)をすべてオフにする。

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

戻り値
    関数が成功すると、MMSYSERR_NOERROR が返る。関数が失敗すると、エラーが返る。返されるエラー値は次のとおりである。

    値                                            

説明                                                                                                                                    

    MMSYSERR_INVALHANDLE

指定されたデバイスハンドルは無効である。

 

解説
    すべての未処理のシステム排他バッファまたはストリーム出力バッファがコールバック関数に返され、MIDIHDR 構造体の dwFlags メンバ

    に MHDR_DONE フラグがセットされます。
    EOX(排他の終わり)バイトを送信せずに、システム排他メッセージを終了すると、受信側デバイスに問題が発生する場合がある。システム

    排他メッセージを終了するとき、midiOutReset 関数は EOX バイトを送信しませんが、アプリケーションがこれを送信する。
    すべての音符をオフにするには、各チャネルの音符ごとにノートオフメッセージを送信する。さらに、各チャネルのサスティンコントローラをオフに

    する。