midiConnect 関数 (mmeapi.h)

  • [アーティクル]

midiConnect 関数は、MIDI 入力デバイスを MIDI スルーまたは出力デバイスに接続するか、MIDI スルー デバイスを MIDI 出力デバイスに接続します。

構文

MMRESULT midiConnect(
  HMIDI    hmi,
  HMIDIOUT hmo,
  LPVOID   pReserved
);

パラメーター

hmi

MIDI 入力デバイスまたは MIDI スルー デバイスへのハンドル。 (デバイスを通じて、このハンドルは 、midiOutOpen 関数の呼び出しによって返されている必要があります。

hmo

MIDI出力またはスルーデバイスへのハンドル。

pReserved

予約; は NULL である必要があります。

戻り値

成功した場合はMMSYSERR_NOERRORを返し、それ以外の場合はエラーを返します。 考えられるエラー値は次のとおりです。

リターン コード 説明
MIDIERR_NOTREADY
 指定された入力デバイスは既に出力デバイスに接続されています。
MMSYSERR_INVALHANDLE
 指定されたデバイス ハンドルが無効です。

解説

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

スルードライバは、MIDI出力ドライバの特別な形式です。 このシステムでは、MIDI 出力デバイスを 1 つの MIDI 入力デバイスに接続できるのは 1 つだけですが、複数の MIDI 出力デバイスをデバイスを通じて MIDI に接続できます。 特定の MIDI 入力デバイスがMIM_DATA メッセージ内のイベント データを受信するたびに、同じイベント データを持つメッセージが、指定された出力デバイス ドライバー (またはスルー ドライバーを介して出力ドライバーに) 送信されます。

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー mmeapi.h (Windows.h を含む)
Library Winmm.lib
[DLL] Winmm.dll

関連項目

MIDI 関数