MidiIoInput

Retrieves the data bytes of a particular MIDI message that has been received at the MIDI Input port.

Synopsis

error = MidiIoInput(eventID, variableName)

Args

eventID is the value of the variable RXSUBID as returned by RXDLG(). See Inputting an event.

variableName is the name of a stem variable where the data bytes are returned. If omitted, then the data bytes are returned in the variable named MIDIEvent. as per MIDI REXX.

Returns

If variableName is supplied, then success returns an empty string, or an error message otherwise. If variableName is omitted, then success returns the number of data bytes (could be 0), or an empty string if an error.

Notes

If there is a buffer overflow error in receiving System Exclusive messages, then the error message returned is MIDI input buffer overrun!.

If you omit the eventID, a SYNTAX condition is raised. CONDITION('E') returns error number 40.5 and CONDITION('D') returns the message Missing argument in invocation of "MIDIIOINPUT"; argument 1 is required.

If there is a problem setting any variable, then a SYNTAX condition is raised.