WORD midiInPrepareHeader(hMidiIn, lpMidiInHdr, wSize)
This function prepares a buffer for MIDI input.
HMIDIIN hMidiIn
Specifies a handle to the MIDI input device.
LPMIDIHDR lpMidiInHdr
Specifies a pointer to a MIDIHDR structure that identifies the buffer to be prepared.
WORD wSize
Specifies the size of the MIDIHDR structure.
Returns zero if the function was successful. Otherwise, it returns an error number. Possible error returns are:
MMSYSERR_INVALHANDLE
Specified device handle is invalid.
MMSYSERR_NOMEM
Unable to allocate or lock memory.
The MIDIHDR data structure and the data block pointed to by its lpData field must be allocated with GlobalAlloc using the GMEM_MOVEABLE and GMEM_SHARE flags, and locked with GlobalLock. Preparing a header that has already been prepared has no effect, and the function returns zero.
midiInUnprepareHeader