This VI returns the CallbackInfo structure used by the clip termination callback function.


..................................................................................................................................................................................................................................................................................


Controls and Indicators


            CallbackInfo IN is a structure containing information required to identify the callback to the system. Key elements are hCamera, uOverlayUse, and bGetClip. The remaining information will be replaced by the GetCallbackInfo VI.


           Occurrence is a LabVIEW occurence that the driver will trigger when the callback function is to be executed. Each occurence should be distinct. For clip capture with no clip termination VI (Path is blank and bGetClip is True), the main application can wait on this occurence to ensure the video clip capture process has completed before formatting the video or aborting the application.


           hCamera is the camera handle of the camera to which the callback function applies.It is set by SetCallback to match hCamera IN. It is ignored if uOverlayUse is set to OVERLAY_FORMAT_IMAGE or OVERLAY_FORMAT_CLIP.


            uOverlayUse is an enumerated list which defines when the overlay callback should be called. Valid flags are:

  • OVERLAY_PREVIEW - The callback is applied to the data before it is displayed in the preview window;
  • OVERLAY_FORMAT_IMAGE - The callback is applied to the data before it is converted by FormatImage;
  • OVERLAY_FORMAT_CLIP - The callback is applied to the data before it is converted by FormatClip; and
  • OVERLAY_FRAME - The callback is applied to the raw data received by the driver.
uOverlayUse is ignored if bGetClip is TRUE.
 

            Path - the full path and file name of the callback VI. This VI should be based on the LVCallbackThreadTemplate.vi if bGetClip is FALSE. or LVClipTerminationFuncThreadTemplate.vi if bGetClip is TRUE. If PATH is blank, the associated overlay callback will be deleted. However, for a Clip Termination callback, a blank Path is an indication that there is no separate callback VI.



            bGetClip is a boolean flag which indicates if the callback is an overlay callback (FALSE - default) or a clip termination callback (TRUE). If bGetClip is TRUE, then uOverlayUSE is ignored.


           uNumberofFrameCaptured is a read-only field that indicates the actual number of frames captured. It is set by the clip termination VI. If there is no clip termination VI, it will be null. 


           error (Get Clip) is the read-only error status of the clip capture routine. It is set by the clip termination VI. If Path is blank, the error (Get Clip) will not be set. Valid only if bGetClip is TRUE.


           TerminationOccurence - for clip capture, this occurence is used by the clip termination function to signal the end of the clip capture and processing. The main application can wait on this occurrence to ensure the clip capture and processing completes. Once the occurence is triggered by the clip termination VI, the main application can process the video clip or safely shutdown.


           PDS Clip Path is the path to the intermediate Pixelink Data Stream (*.pds) file. Required if bGetClip is set to TRUE.


           AVI Clip Path is the path to the processed AVI file. It would be useful if the clip termination VI could process the PDS file into an AVI file. However, there is a unknown problem with the Windows libraries that does not allow the FormatClip VI to be run outside the main thread. Consider AVI Clip Path to be a place holder only. 


               hCamera OUT has the same value as hCamera IN.


              CallbackInfo OUT has the same structure as CallbackInfo IN. The values of uNumberofFrameCaptured and error(Get Clip) will reflect the results of the clip capture.



Equivalent API Function: PxLGetCallbackInfo


Details


GetCallbackInfo will only return meaningful results if a video clip has been captured and a clip termination callback function has been used to signal the end of the clip capture.


For more information, see Callback VIs.


Note: See Error Handling for error input and output information and error codes.