midiInPrepareHeader
The midiInPrepareHeader
function prepares a buffer for MIDI input.
MMRESULT midiInPrepareHeader(
|
HMIDIIN hMidiIn, |
|
|
LPMIDIHDR lpMidiInHdr, |
|
|
UINT cbMidiInHdr |
|
|
); |
|
Parameters
hMidiIn
Handle of the
MIDI input device.
lpMidiInHdr
Address of a MIDIHDR structure that identifies
the buffer to be prepared.
cbMidiInHdr
Size, in
bytes, of the MIDIHDR structure.
Return Values
Returns
MMSYSERR_NOERROR if successful or an error otherwise. Possible error values
include the following:
|
MMSYSERR_INVALHANDLE |
The
specified device handle is invalid. |
|
MMSYSERR_INVALPARAM |
The
specified address is invalid. |
|
MMSYSERR_NOMEM |
The system
is unable to allocate or lock memory. |
Remarks
Preparing a
header that has already been prepared has no effect, and the function returns
zero.
Before using
this function, you must set the lpData, dwBufferLength, and dwFlags
members of the MIDIHDR structure. The dwFlags member must be set
to zero.
See Also