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を返し、それ以外の場合はエラーを返します。 考えられるエラー値は次のとおりです。
リターン コード | 説明 |
---|---|
|
指定された入力デバイスは既に出力デバイスに接続されています。 |
|
指定されたデバイス ハンドルが無効です。 |
解説
この関数を呼び出した後、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 |