MIM_MOREDATA メッセージ

MIM_MOREDATA メッセージは、MIDI 入力デバイスが MIDI メッセージを受信したときに MIDI 入力コールバック関数に送信されますが、アプリケーションは、入力デバイス ドライバーに追いつくために十分な速さでMIM_DATAメッセージを処理していません。 コールバック関数は、アプリケーションが midiInOpen 関数の呼び出しでMIDI_IO_STATUSを指定した場合にのみ、このメッセージを受信します。

MIM_MOREDATA 
dwParam1 = dwMidiMessage 
dwParam2 = dwTimestamp 

パラメーター

dwMidiMessage

受信した MIDI メッセージを指定します。 メッセージは、次のようにDWORD値にパックされます。

要件	値	説明
高い単語	高次バイト	使用されていません。
	下位バイト	MIDI データの 2 バイト目が含まれます (必要な場合)。
低い単語	高次バイト	MIDI データの最初のバイトが含まれます (必要な場合)。
	下位バイト	MIDI ステータスが含まれます。

MIDI ステータス バイトに応じて、2 つの MIDI データ バイトは省略可能です。

dwTimestamp

入力デバイス ドライバーがメッセージを受信した時刻を指定します。 タイムスタンプは、 midiInStart 関数が呼び出されたときに 0 から始まるミリ秒単位で指定されます。

戻り値

このメッセージは値を返しません。

解説

アプリケーションでは、MIM_MOREDATA メッセージの処理を最小限に抑える必要があります。 (特に、アプリケーションでは、MIM_MOREDATAの処理中に PostMessage 関数を呼び出さないでください。代わりに、アプリケーションはイベント データをバッファーに配置してから、 を返す必要があります。

アプリケーションは、一連の MIM_MOREDATA メッセージの後にMIM_DATAメッセージを受信すると、着信 MIDI イベントに追い付き、時間のかかる関数を安全に呼び出すことができます。

MIDI 入力ポートから受信した MIDI メッセージの実行状態が無効になっています。各メッセージが展開され、MIDI ステータス バイトが含まれます。

MIDI システム排他メッセージを受信した場合、このメッセージは送信されません。

必要条件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
ヘッダー	Mmsystem.h (Windows.h を含む)

関連項目

MIDI (Musical Instrument Digital Interface : 楽器デジタル インターフェイス)

MIDI メッセージ