The MidiChannel interface specifies many methods that are not necessarily implemented by all synthesizers. Examples:

1) setMono is superseded and not available in modern Synthesizers, which couldn't leverage the extra processing power in mono mode.

2) setProgram(int, int) may fail if the Synthesizer's soundbank does not contain the specific bank.

3) PolyPressure is only available in high-end Synthesizers

4) localControl is a function for devices with built-in keyboard

In total, this request affects the following methods:

setPolyPressure
getPolyPressure
setChannelPressure
getChannelPressure
setControlChange
getController
programChange(int)
programChange(int, int)
getProgram
setPitchBend
getPitchBend
localControl
setMono
getMono
setOmni
getOmni
setMute
getMute
setSolo
getSolo


The suggested fix is to allow setXXX methods to fail and explicitely ask the user to check the success with the corresponding getXXX method.

======================================================================

  xxxxx@xxxxx   2003-10-22
Integrated changes to Doc per CCC request 4931588.
Reviewed by Florian

N/A

  xxxxx@xxxxx   2003-10-02
	Important to clarify the API. The implementation already behaves this way.