qmk/docs/internals/input_callback_reg.md

group input_callback_reg

These are the functions you use to register your input callbacks.

The functions are called when the appropriate midi message is matched on the associated device's input.

Summary

Members	Descriptions
public void midi_register_cc_callback(MidiDevice * device,midi_three_byte_func_t func)	Register a control change message (cc) callback.
public void midi_register_noteon_callback(MidiDevice * device,midi_three_byte_func_t func)	Register a note on callback.
public void midi_register_noteoff_callback(MidiDevice * device,midi_three_byte_func_t func)	Register a note off callback.
public void midi_register_aftertouch_callback(MidiDevice * device,midi_three_byte_func_t func)	Register an after touch callback.
public void midi_register_pitchbend_callback(MidiDevice * device,midi_three_byte_func_t func)	Register a pitch bend callback.
public void midi_register_songposition_callback(MidiDevice * device,midi_three_byte_func_t func)	Register a song position callback.
public void midi_register_progchange_callback(MidiDevice * device,midi_two_byte_func_t func)	Register a program change callback.
public void midi_register_chanpressure_callback(MidiDevice * device,midi_two_byte_func_t func)	Register a channel pressure callback.
public void midi_register_songselect_callback(MidiDevice * device,midi_two_byte_func_t func)	Register a song select callback.
public void midi_register_tc_quarterframe_callback(MidiDevice * device,midi_two_byte_func_t func)	Register a tc quarter frame callback.
public void midi_register_realtime_callback(MidiDevice * device,midi_one_byte_func_t func)	Register a realtime callback.
public void midi_register_tunerequest_callback(MidiDevice * device,midi_one_byte_func_t func)	Register a tune request callback.
public void midi_register_sysex_callback(MidiDevice * device,midi_sysex_func_t func)	Register a sysex callback.
public void midi_register_fallthrough_callback(MidiDevice * device,midi_var_byte_func_t func)	Register fall through callback.
public void midi_register_catchall_callback(MidiDevice * device,midi_var_byte_func_t func)	Register a catch all callback.

Members

public void midi_register_cc_callback(MidiDevice * device,midi_three_byte_func_t func)

Register a control change message (cc) callback.

Parameters

• device the device associate with

• func the callback function to register

public void midi_register_noteon_callback(MidiDevice * device,midi_three_byte_func_t func)

Register a note on callback.

Parameters

• device the device associate with

• func the callback function to register

public void midi_register_noteoff_callback(MidiDevice * device,midi_three_byte_func_t func)

Register a note off callback.

Parameters

• device the device associate with

• func the callback function to register

public void midi_register_aftertouch_callback(MidiDevice * device,midi_three_byte_func_t func)

Register an after touch callback.

Parameters

• device the device associate with

• func the callback function to register

public void midi_register_pitchbend_callback(MidiDevice * device,midi_three_byte_func_t func)

Register a pitch bend callback.

Parameters

• device the device associate with

• func the callback function to register

public void midi_register_songposition_callback(MidiDevice * device,midi_three_byte_func_t func)

Register a song position callback.

Parameters

• device the device associate with

• func the callback function to register

public void midi_register_progchange_callback(MidiDevice * device,midi_two_byte_func_t func)

Register a program change callback.

Parameters

• device the device associate with

• func the callback function to register

public void midi_register_chanpressure_callback(MidiDevice * device,midi_two_byte_func_t func)

Register a channel pressure callback.

Parameters

• device the device associate with

• func the callback function to register

public void midi_register_songselect_callback(MidiDevice * device,midi_two_byte_func_t func)

Register a song select callback.

Parameters

• device the device associate with

• func the callback function to register

public void midi_register_tc_quarterframe_callback(MidiDevice * device,midi_two_byte_func_t func)

Register a tc quarter frame callback.

Parameters

• device the device associate with

• func the callback function to register

public void midi_register_realtime_callback(MidiDevice * device,midi_one_byte_func_t func)

Register a realtime callback.

The callback will be called for all of the real time message types.

Parameters

• device the device associate with

• func the callback function to register

public void midi_register_tunerequest_callback(MidiDevice * device,midi_one_byte_func_t func)

Register a tune request callback.

Parameters

• device the device associate with

• func the callback function to register

public void midi_register_sysex_callback(MidiDevice * device,midi_sysex_func_t func)

Register a sysex callback.

Parameters

• device the device associate with

• func the callback function to register

public void midi_register_fallthrough_callback(MidiDevice * device,midi_var_byte_func_t func)

Register fall through callback.

This is only called if a more specific callback is not matched and called. For instance, if you don't register a note on callback but you get a note on message the fall through callback will be called, if it is registered.

Parameters

• device the device associate with

• func the callback function to register

public void midi_register_catchall_callback(MidiDevice * device,midi_var_byte_func_t func)

Register a catch all callback.

If registered, the catch all callback is called for every message that is matched, even if a more specific or the fallthrough callback is registered.

Parameters

• device the device associate with

• func the callback function to register