<Return[MN]><Top>

midiInPrepareHeader

Declare Function Api_midiInPrepareHeader& Lib "winmm" Alias "midiInPrepareHeader" (ByVal hMidiIn&, lpMidiInHdr As MIDIHDR, ByVal cbMidiInHdr&)

Declare Function midiInPrepareHeader Lib "winmm" (ByVal hMidiIn As Long, lpMidiInHdr As MIDIHDR, ByVal cbMidiInHdr As Long) As Long

MIDI 入力のためのバッファを準備する。

パラメータ
hMidiIn
    MIDI 入力デバイスのハンドルを指定する。
lpMidiInHdr
    準備するバッファを識別する MIDIHDR 構造体のアドレスを指定する。
cbMidiInHdr
    MIDIHDR 構造体のサイズをバイト単位で指定する。

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

    値                                             

説明                                                                                                 

    MMSYSERR_INVALHANDLE

hmi パラメータで指定されたハンドルは無効である。

    MMSYSERR_INVALPARAM

指定されたアドレスは無効である。

    MMSYSERR_NOMEM

システムはメモリを割り当てられないか、またはロックできない。

　

解説
    既に準備されているヘッダーを準備した場合は何も起こらず、関数は 0 を返す。
    この関数を使う前に、MIDIHDR 構造体のメンバ lpData、dwBufferLength および dwFlags を設定する必要がある。dwFlags メンバは

    必ず 0 に設定する。