Assembly: Cognex.VisionPro.GenTL (in Cognex.VisionPro.GenTL.dll) Version: 73.0.0.0
Parameters
- info
- Type: Cognex.VisionPro ICogAcqInfo
Return Value
Type: ICogImageThe acquired image.
Implements
ICogAcqFifo CompleteAcquireEx(ICogAcqInfo)| Exception | Condition |
|---|---|
| CogAcqTimeoutException | Timeout period expired. |
| CogAcqBadTicketException | Ticket is −1 and there is no outstanding StartAcquire , or if there is no StartAcquire for this Ticket. |
| CogAcqOldTicketException | The image corresponding to Ticket has already been collected. |
| CogAcqOverrunException | A trigger could not be serviced. |
| CogAcqAbnormalException | The acquisition failed because of a fault in the acquisition hardware or because of some other unusual problem. |
| CogAcqEncoderOverrunException | Encoder overrun. |
| CogAcqInvalidROIException | The region of interest is not valid. |
| CogAcqNoOutstandingStartsException | Ticket was −1, but there were no outstanding StartAcquire requests |
| CogAcqOtherFifoErrorException | There was an error in another FIFO in the same master/slave group. |
Completes the acquisition specified by the requested ticket and returns the acquired image. This method is the same as CompleteAcquire(Int32, Int32 , Int32 ) but passes and returns its results in an ICogAcqInfo .
Note: If you are completing an automatically triggered acquisition (one for which StartAcquire was not called), then you must either omit the RequestedTicket property of the info argument or supply a value of -1.
Under some conditions, the VisionPro acquisition system may fire a Complete event when there is no completed acquisition available. If you call CompleteAcquireEx(ICogAcqInfo) when this happens, you will receive a timeout error, or possibly some other error. This happens primarily when you disable triggers and Flush the FIFO (to stop acquisitions), and the Complete event for the flushed image fires. To avoid this situation, be sure to call GetFifoState(Int32 , Int32 , Boolean ), to determine whether there really is an image pending.
CompleteAcquireEx(ICogAcqInfo) can fire Complete, MovePart, and Overrun.