midiInStart 関数 (mmeapi.h)

  • [アーティクル]

midiInStart 関数は、指定された MIDI 入力デバイスで MIDI 入力を開始します。

構文

MMRESULT midiInStart(
  HMIDIIN hmi
);

パラメーター

hmi

MIDI 入力デバイスへのハンドル。

戻り値

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

リターン コード 説明
MMSYSERR_INVALHANDLE
 指定されたデバイス ハンドルが無効です。

解説

この関数は、タイム スタンプを 0 にリセットします。後続に受信したメッセージのタイム スタンプ値は、この関数が呼び出された時刻を基準にしています。

システム排他メッセージを除くすべてのメッセージは、受信時にクライアントに直接送信されます。 システム排他メッセージは、 midiInAddBuffer 関数によって提供されるバッファーに配置されます。 キューにバッファーがない場合、システム排他データはクライアントに通知されずに破棄され、入力は続行されます。 バッファーは、完全なシステム排他メッセージが受信されたとき、または midiInReset 関数が使用されている場合に、クライアントに返されます。 MIDIHDR 構造体の dwBytesRecorded メンバーには、受信したデータの実際の長さが含まれます。

入力が既に開始されている場合にこの関数を呼び出しても効果はなく、関数は 0 を返します。

要件

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

関連項目

MIDI 関数