<Return[MN]><Top>

midiConnect

Declare Function Api_midiConnect& Lib "winmm" Alias "midiConnect" (ByVal hMidi&, ByVal hmo&, pReserved As Any)

Declare Function midiConnect Lib "winmm" Alias "midiConnect" (ByVal hMidi As Long, ByVal hmo As Long, pReserved As Any) As Long

MIDI 入力デバイスを MIDI 通過デバイスまたは MIDI 出力デバイスに接続する。または、MIDI 通過デバイスを MIDI 出力デバイスに接続する。

パラメータ
hMidi
    MIDI 入力デバイスまたは MIDI 通過デバイスのハンドルを指定する(MIDI 通過デバイスを指定する場合このハンドルは、midiOutOpen 関

    数の呼び出しによって返されたものでなければならない)。
hmo
    MIDI 出力デバイスまたは MIDI 通過デバイスのハンドルを指定する。
pReserved
    予約されている。NULL を指定する。

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

    値                                             

説明                                                                                      

    MIDIERR_NOTREADY

指定された入力デバイスは、既に出力デバイスに接続されている。

    MMSYSERR_INVALHANDLE

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


解説
    この関数の呼び出し後、同じイベントデータを持つメッセージが出力デバイスドライバに送信されるたびに、MIDI 入力デバイスは

    MIM_DATA メッセージのイベントデータを受信する。
    通過ドライバは、MIDI 出力ドライバの特別な形態である。システムにより、MIDI 入力デバイスに接続できる MIDI 出力デバイスは 1 つに

    制限されているが、MIDI 通過デバイスには複数の MIDI 出力デバイスを接続することができる。指定された MIDI 入力デバイスが

    MIM_DATA メッセージのイベントデータを受信した場合は常に、指定された出力デバイスドライバに(または通過ドライバを経由して出力ドライ

    バに)同じイベントデータを持つメッセージが送信される。