CogAcqFifoGenTL.CompleteAcquire Method

CogAcqFifoGenTL CompleteAcquire Method

Cognex VisionPro 9.7

Completes the acquisition specified by the given ticket and returns the acquired image. If the ticket is omitted, or set to -1, the uncompleted acquire that was least recently started will be completed.

Namespace: Cognex.VisionPro.GenTL.Implementation.Internal
Assembly: Cognex.VisionPro.GenTL (in Cognex.VisionPro.GenTL.dll) Version: 73.0.0.0

Syntax

C++

Copy to Clipboard Print

public virtual ICogImage CompleteAcquire(
	int requestedTicket,
	out int ticket,
	out int triggerNumber
)

public virtual ICogImage CompleteAcquire(
	int requestedTicket,
	out int ticket,
	out int triggerNumber
)

Public Overridable Function CompleteAcquire ( 
	requestedTicket As Integer,
	<OutAttribute> ByRef ticket As Integer,
	<OutAttribute> ByRef triggerNumber As Integer
) As ICogImage

Public Overridable Function CompleteAcquire ( 
	requestedTicket As Integer,
	<OutAttribute> ByRef ticket As Integer,
	<OutAttribute> ByRef triggerNumber As Integer
) As ICogImage

public:
virtual ICogImage^ CompleteAcquire(
	int requestedTicket, 
	[OutAttribute] int% ticket, 
	[OutAttribute] int% triggerNumber
)

public:
virtual ICogImage^ CompleteAcquire(
	int requestedTicket, 
	[OutAttribute] int% ticket, 
	[OutAttribute] int% triggerNumber
)

Parameters

requestedTicket: Type: System Int32
The ticket of an outstanding acquisition. This is usually a value returned by StartAcquire . If this value is omitted or set to -1, the oldest outstanding acquisition is completed. requestedTicket must be -1 for automatically triggered acquisitions.

ticket: Type: System Int32
The actual ticket of the completed acquisition. When requestedTicket is not −1, this value is the same as requestedTicket.

triggerNumber: Type: System Int32
The trigger sequence number of the completed acquisition. You can compare this value with Trigger value returned by Acquire(Int32 ) to see if there were missed triggers.

Return Value

Type: ICogImage

The acquired image.

Implements

ICogAcqFifo CompleteAcquire(Int32, Int32 , Int32 )

Exceptions

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.

Remarks

Completes the acquisition specified by the given ticket and returns the acquired image. If ticket is omitted, or set to -1, the oldest outstanding acquisition will be completed.

Note: If you are completing an automatically triggered acquisition (one for which StartAcquire was not called), then you must either omit the requestedTicket 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 CompleteAcquire(Int32, Int32 , Int32 ) 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.

CompleteAcquire(Int32, Int32 , Int32 ) can fire Complete, MovePart, and Overrun.