Fcalva/gint
1
0
Fork 0
mirror of https://git.planet-casio.com/Lephenixnoir/gint.git synced 2024-12-29 13:03:36 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions

kernel: more detailed quit handler documentation

Browse source
This commit is contained in:
Lephe 2022-11-27 22:57:50 +01:00
parent a5fb6d3401
commit 3192078c4c
No known key found for this signature in database
GPG key ID: 1BBA026E13FC0495
1 changed files with 17 additions and 7 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

22
include/gint/gint.h
View file

@ -109,15 +109,25 @@ static GINLINE void *gint_inthandler(int code, void const *h, size_t size) {
Returns the return value of the callback. */
extern int (*gint_inth_callback)(gint_call_t const *call);
/* gint_set_quit_handler(): Call a GINT_CALL when the user open another add-in
/* gint_set_quit_handler(): Setup a call to be invoked when leaving the add-in
This function use the SetQuitHandler syscall to call a function when the
user open another add-in.
This function sets up the provided GINT_CALL() to be invoked when the
add-in is unloaded, which is either when we exit from main() or when
starting another application from the main menu. Crucially, this is only
*after* selecting an application, not before opening the main menu. The
quit handler is not invoked if the user re-enters the add-in.
@call A GINT_CALL
@do_world_switch 1 to execute @call in a world_switch. */
This is based on the SetQuitHandler() syscall, and therefore the callback
runs in the OS world by default. If [run_in_os_world] is set to false, a
world switch will be performed to run the callback in the gint world.
void gint_set_quit_handler(gint_call_t gcall, bool do_world_switch);
TODO: Currently the quit handler is not called when exiting from main().
TODO: Detail how this interacts with destructor functions!
TODO: [run_in_os_world == false] is not honored yet (because unstable)
@call Callback to be performed when leaving add-in
@run_in_os_world true to stay in OS world, false to use gint world */
void gint_set_quit_handler(gint_call_t gcall, bool run_in_os_world);
#ifdef __cplusplus
}