# Disable local control on MIDI devices

``

    midi_local_control_off

Sends a MIDI local control off message to all connected devices on all channels. Use the `port:` and `channel:` opts to restrict which MIDI ports and channels are used.

All devices on a given channel will respond only to data received over MIDI. Played data, etc. will be ignored. See `midi_local_control_on` to enable local control.

MIDI 1.0 Specification - Channel Mode Messages - Local Control Off

Introduced in v3.0

## Options

channel: | Channel to send the local control off message to
port: | MIDI port to send to
on: | If specified and false/nil/0 will stop the midi local control off message from being sent out. (Ensures all opts are evaluated in this call to `midi_local_control_off` regardless of value).

## Examples

# Example 1
``
    midi_local_control_off
| ``
    #=> Disable local control on MIDI devices on all channels (and ports)
# Example 2
``
    midi_local_control_off channel: 2
| ``
    #=> Disable local control on MIDI devices on channel 2