imaq1394InstallCallback

Format

rval = imaq1394InstallCallback (SESSION_ID sessionId, int event, IMAQ1394_CALL_BACK_PTR callBackFunction, void *parameter);

Purpose

Configures the NI-IMAQ for IEEE 1394 Cameras driver to execute a callback function when an event occurs.

Note  Because the callback executes in a different thread, make sure that the code inside the callback is thread safe.

Parameters

Parameter	Type	Description
sessionId	SESSION_ID	A valid Session ID, which you can obtain using imaq1394CameraOpen2.
event	int	The event to monitor. The following events are valid: IMG1394_EVENT_FRAME_DONE: Callback fired when a frame is transferred from the camera into system memory. IMG1394_EVENT_CAMERA_ATTACHED: Callback fired when a new camera is attached. IMG1394_EVENT_CAMERA_DETACHED: Callback fired when the camera is detached.
callBackFunction	IMAQ1394_CALL_BACK_PTR	The address of the callback function.
parameter	void *	A pointer to user-defined data passed to the event function.

Return Value

On success, this function returns IMG1394_ERR_GOOD. On failure, this function returns an error code. You can obtain a more detailed error message with imaq1394ShowError.