Callback functions

When an event occurs, and event notification is enabled for that event, Euresys::EGrabber executes one of several callback functions.

These callback functions are defined in overridden virtual methods:

class MyGrabber : public Euresys::EGrabber<>
{
    public:
        ...

    private:
        // callback function for new buffer events
        virtual void onNewBufferEvent(const NewBufferData& data) {
            ...
        }

        // callback function for data stream events
        virtual void onDataStreamEvent(const DataStreamData &data) {
            ...
        }

        // callback function for CIC events
        virtual void onCicEvent(const CicData &data) {
            ...
        }

        // callback function for I/O toolbox events
        virtual void onIoToolboxEvent(const IoToolboxData &data) {
            ...
        }

        // callback function for CoaXPress interface events
        virtual void onCxpInterfaceEvent(const CxpInterfaceData &data) {
            ...
        }
};

As you can see, a different callback function can be defined for each category of events.

In .NET, callback functions are defined by creating delegates rather than overriding virtual methods. An example will be given in the chapter about the .NET assembly.