<Return[MN]><Top>

midiOutClose

Declare Function Api_midiOutClose& Lib "winmm" Alias "midiOutClose" (ByVal hmo&)

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

指定された MIDI 出力デバイスをクローズする。

パラメータ
hmo
    MIDI 出力デバイスのハンドルを指定する。関数が成功すると、この関数の呼び出し後にハンドルは無効になる。

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

    値                                             

説明                                                               

    MIDIERR_STILLPLAYING

バッファはまだキューにある。 

    MMSYSERR_INVALHANDLE

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

    MMSYSERR_NOMEM

システムはマッパー文字列記述をロードできない。


解説
    midiOutLongMsg 関数を使って送信された出力バッファがあり、それがアプリケーションに返されていない場合、クローズ処理は失敗する。

    未処理のバッファを処理済みにするには、midiOutReset 関数を使う。