| EV_hook | Variable (ROM Call 0x2A3)

events.h

EVENT_HANDLER EV_hook;

A global variable pointing to the "hook" event handler.

EV_hook is a global pointer variable which points to the "hook" event handler (or NULL if there is no "hook" handler installed. Hook handler hooks events like EV_captureEvents, however, the application handler (either default application handler or user handler installed with EV_captureEvents) is still called afterwards (see EV_sendEvent for more info. This is probably meant for debugging purposes as it is never used in TIOS.
Using EV_hook you can capture all messages and process them as you like, without overriding current handlers. So, you can use it to change behaviour of some events, or add new functionalities. DoorsOS for example uses EV_hook to add SHIFT+ON feature. You also can hook the APPS key and display a different menu in which your application set will be listed (then you can start your own event driven application via EV_captureEvents). If you understand principles described in this header file, this is not so hard. If you didn't understand what is written here, don't try to play with this...

Used by: EV_centralDispatcher, EV_sendEventSide, HomeStore