Skip to content

Latest commit

 

History

History
95 lines (78 loc) · 2.85 KB

nf-mmeapi-midiinstart.md

File metadata and controls

95 lines (78 loc) · 2.85 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:mmeapi.midiInStart
midiInStart function (mmeapi.h)
The midiInStart function starts MIDI input on the specified MIDI input device.
_win32_midiInStart
midiInStart
midiInStart function [Windows Multimedia]
mmeapi/midiInStart
multimedia.midiinstart
multimedia\midiinstart.htm
Multimedia
c8d570a2-30a2-453e-a320-7b097c4e90bb
12/05/2018
_win32_midiInStart, midiInStart, midiInStart function [Windows Multimedia], mmeapi/midiInStart, multimedia.midiinstart
mmeapi.h
Windows.h
Windows
Windows 2000 Professional [desktop apps only]
Windows 2000 Server [desktop apps only]
Winmm.lib
Winmm.dll
Windows
19H1
midiInStart
mmeapi/midiInStart
c++
APIRef
kbSyntax
DllExport
Winmm.dll
API-MS-Win-mm-mme-l1-1-0.dll
winmmbase.dll
midiInStart

midiInStart function

-description

The midiInStart function starts MIDI input on the specified MIDI input device.

-parameters

-param hmi

Handle to the MIDI input device.

-returns

Returns MMSYSERR_NOERROR if successful or an error otherwise. Possible error values include the following

Return code Description
MMSYSERR_INVALHANDLE
The specified device handle is invalid.

-remarks

This function resets the time stamp to zero; time stamp values for subsequently received messages are relative to the time that this function was called.

All messages except system-exclusive messages are sent directly to the client when they are received. System-exclusive messages are placed in the buffers supplied by the midiInAddBuffer function. If there are no buffers in the queue, the system-exclusive data is thrown away without notification to the client and input continues. Buffers are returned to the client when they are full, when a complete system-exclusive message has been received, or when the midiInReset function is used. The dwBytesRecorded member of the MIDIHDR structure will contain the actual length of data received.

Calling this function when input is already started has no effect, and the function returns zero.

-see-also

MIDI Functions