MidiDevices.EventReadRawInfoGet method |
|
Remarks
Obtains information about a raw MIDI event reported by the MidiDevicesEventReceived event. Raw data of the MIDI event can be obtained through a subsequent call to the MidiDevices.EventReadRaw method.
For further details about the use of MIDI devices see the MidiDevices object section and the How to manage MIDI devices tutorial.
Syntax
[Visual Basic] control.MidiDevices.EventReadRawInfoGet ( nEventUniqueId as Integer, nDeviceUniqueId as Integer, nBufferLen as Long, nTimeStamp as Long ) as enumDjcErrorCodes |
[C++] short control.MidiDevices.EventReadRawInfoGet ( short nEventUniqueId, short *nDeviceUniqueId, long *nBufferLen, long *nTimeStamp ); |
Parameter |
Description |
|
|
nEventUniqueId |
The unique identifier of the MIDI event reported by the MidiDevicesEventReceived event. After calling this method the event is internally deleted from the queue of MIDI events so this unique identifier becomes automatically invalid. |
nDeviceUniqueId |
Reference that, on return from the method call, will contain the unique identifier (returned by a previous call to the MidiDevices.Open method) of the MIDI input device which generated the event. |
nBufferLen |
Reference that, on return from the method call, will contain the size in bytes of the incoming raw event. Through the provided size it will be possible allocating a buffer big enough to contain raw data of the MIDI event through a subsequent call to the MidiDevices.EventReadRaw method. |
nTimeStamp |
Reference that, on return from the method call, will contain the time stamp of the event expressed in milliseconds elapsed from the moment in which the MIDI input device was opened through a call to the MidiDevices.Open method. |
Return value
Value |
Meaning |
|
|
Negative value |
An error occurred, check the LastError property value in order to get the error code |
enumErrorCodes.ERR_NOERROR (0) |
The method call was successful |