This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

PtAppAddCallback()

Add a callback to an application's callback list

Synopsis:

void PtAppAddCallback(
        unsigned long cb_type,
        int (*func)(void*,PtCallbackInfo_t*),
        void *data );

Arguments:

cb_type: The name of the callback list you want to add the function to. For example, Pt_CB_APP_EXIT.
func: A pointer to the function you want to add. The function takes this form: int (*func)(PtCallbackInfo_t *, void *).
data: A pointer to data that you want to pass as the second argument to the function.

Library:

ph

Description:

This function adds a callback to the application's callback list. For a list of application callbacks, see PtAppSetResources().

For more information, see the Manipulating Resources in Application Code chapter of the Photon Programmer's Guide.

Returns:

0: Success.
-1: An error occurred.

Examples:

int exit_cb(void *data,
               PtCallbackInfo_t *cbinfo)
{
  printf( "I\'m exiting\n" );
  return( Pt_CONTINUE );
};
...
PtAppAddCallback(Pt_CB_APP_EXIT, exit_cb, NULL);

Classification:

Photon

Safety:
Interrupt handler	No
Signal handler	No
Thread	No