Callback Function Prototype
The callback function prototype is declared in the MultiCam system's MultiCam.h header file as follows:
typedef void (MCAPI *PMCCALLBACK)(PMCSIGNALINFO SignalInfo);
Item |
Type |
Description |
Function |
PMCCALLBACK |
Callback function |
SignalInfo |
PMCSIGNALINFO |
Argument providing the signal information structure. |
The user should define the callback function in the application code in accordance with this prototype.
The callback function is called by the MultiCam driver when a channel or a processor issues a pre-defined signal.
The pre-defined signal should be enabled with the SignalEnable parameter. It is allowed to enable several signals.
If more than one enabled signals are issued simultaneously from an object, the callback function is successively called for each signal occurrence.
When the signal occurs, the callback dedicated thread is released, and the callback function is automatically invoked. The thread is restored to an idle condition when the callback function is exited.
The function has a single argument, which is a structure passing information on the signal that caused the callback function. This structure has the signal information type.
If the callback signaling mechanism is used, the waiting and advanced signaling mechanisms cannot be used.