Outputs one MIDI message of limited size to the currently open MIDI Out port.
Synopsis
error = MidiIoOutShort(channel, type, data)
Args
channel is the MIDI channel upon which the event is output. If omitted, then the same channel as the last MidiIoOutShort() event is used.
type is the desired type of event to output. This can be expressed either as an ID number or ID name. If omitted, then the same type as the last MidiIoOutShort() event is used.
data are the data values for the event. If omitted, then the same data values as the last MidiIoOutShort() event are used. What data values you supply, and what they signify, depends upon type.
Returns
An empty string if successful, or an error message if a failure.
Notes
If you call MidiIoOutShort() before calling MidiIoOpenPort() to open a port, then a REXX SYNTAX condition is raised. CONDITION('E') returns error number 40.1 and CONDITION('D') returns the message DLL function "MIDIIOOUTSHORT" reported MIDI port is not open!.
If you pass a non-numeric value for channel or data, then a SYNTAX condition is raised. CONDITION('E') returns error number 40.12 and CONDITION('D') returns the message MIDIIOOUTSHORT argument <XX> must be a whole number; found "<badarg>" where <XX> is 1 for channel or 3 for data, and <badarg> is what you erroneously passed.
If you pass an ID name for type that is not one of the allowable names, then a REXX SYNTAX condition is raised. CONDITION('E') returns error number 40.1 and CONDITION('D') returns the message DLL function "MIDIIOOUTSHORT" reported Unsupported type of event!.
For all other errors, the error message depends upon the driver for the MIDI Interface you're using. It could be any error message returned by that driver.
Examples
See Outputting an event.