imaq1394InstallCallback

NI-IMAQ for IEEE 1394 Cameras Function

previous page next page

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.

previous page start next page