---

PtAddFilterCallback()

Add a filter callback to an application's callback list

Synopsis:

void PtAddFilterCallback(
        unsigned long event_mask,
        int (*func)(void *,PtCallbackInfo_t *),
        void *data);

Arguments:

event_mask

The event type that causes the application to invoke the filter callback func.

func

A pointer to the event handler function you want to add. The function takes this form: int (*func)(void *,PtCallbackInfo_t *).

data

A pointer to data that you want to pass as the first argument to the function.

Library:

ph

Description:

This function adds an event handler to the application's Pt_CB_FILTER callback list. The application invokes this handler whenever an event type that matches one of the bits in event_mask intersects with the application .

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

Classification:

Photon

Safety:
Interrupt handler	No
Signal handler	No
Thread	No

See also:

PtAppGetResources(), PtAppGetResource(), PtAppRemoveCallback(), PtAppRemoveFilterCallback(), PtAppSetResource(), PtAppSetResources(), PtSetArg().

"Event handlers" in the Managing Widgets in Application Code chapter of the Photon Programmer's Guide

---