PK_DEBUG_SESSION_watch_fns

PK_ERROR_code_t              PK_DEBUG_SESSION_watch_fns
(
--- received arguments ---
int                          n_fns,            --- number of functions
                                               --- to watch
const char                  *fns[],            --- functions to watch
PK_POINTER_t                 entry_context,    --- entry context information
PK_POINTER_t                 exit_context,     --- exit context information
PK_DEBUG_SESSION_entry_cb_t  entry_fn,         --- entry callback
                                               --- (may be NULL)
PK_DEBUG_SESSION_exit_cb_t   exit_fn           --- exit callback
                                               --- (may be NULL)
)


This function registers an array of PK functions that are to be watched
via two application callback functions.



The application may register an array of PK functions to watch via an
entry and an exit callback function. If the number of functions to
watch is zero, and at least one of the callback functions is not NULL
then all functions are watched.

If the entry callback function is not NULL, it will be invoked at the
point when one of the watched functions is entered. If the exit
callback is not NULL, it will be invoked at the point when one of the
watched functions is exited. The name of the function being watched
and 'entry_context' or 'exit_context' will be passed to each of the
callback functions.

This function may be called before or after the session has been
started (ie. before or after a call to PK_SESSION_start). This
function must not be invoked before a frustrum has been registered via
PK_SESSION_register_frustrum. Those PK functions that are called from
registered callback functions will not be watched.

The system to watch functions may be disabled by invoking the API and
specifying NULL for both the entry and the exit callback functions.

See here for more information on this function.

NOTE: This function is only to be used for debugging purposes.