<Return[MN]><Top>

midiInClose

Declare Function Api_midiInClose& Lib "winmm" Alias "midiInClose" (ByVal hMidiIn&)

Declare Function midiInClose Lib "winmm" (ByVal hMidiIn As Long) As Long

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

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

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

    値                                             

説明                                                                                                 

    MIDIERR_STILLPLAYING

lpMidiInHdr パラメータで指定されたバッファは、まだキューにある。

    MMSYSERR_INVALHANDLE

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

    MMSYSERR_NOMEM

システムはメモリを割り当てられないか、またはロックできない。


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

    コールバック関数を介して未処理のすべてのバッファを返すには、midiInReset 関数を使う。