StartAcquisition

StartAcquisition 1:

Send the 'StartAcquisitionCommands' defined in the TcVnGevImageProvider TcCOM module to the camera.

Syntax

Definition:

METHOD StartAcquisition : HRESULT

StartAcquisition 2: Return value

HRESULT

Further information

The method StartAcquisition starts the image acquisition by a camera. What this means in the individual case depends on the parameterization of the camera. Further information about this can be found in the sample Image acquisition and trigger. The image acquisition can be started from the INITIAL, INITIALIZED and OPENED states.

If the camera is still in INITIAL or INITIALIZED, the method StartAcquisition also performs the tasks of the method OpenCamera. Usually, the OPENED state is not assumed.

State transitions

With StartAcquisition the camera is to be placed in the ACQUIRING state. This can take place from the INITIAL, INITIALIZED and OPENED states. If the camera is in INITIAL or INITIALIZED, the state transition to OPENED is performed first. As a rule, this takes place via the intermediate state OPENING. The transition from OPENED to ACQUIRING usually takes place via the intermediate state STARTACQUISITION.

StartAcquisition 3:
State transitions with FB_VN_GevCameraControl.StartAcquisition

All possible state transitions and their return codes are shown in the following transition matrix:

Return Codes (HRESULT)

Result state

INITIAL

INITIALIZED

OPENING

OPENED

STARTACQUISITION

ACQUIRING

ERROR

Initial state

INITIAL

BUSY

-

PENDING

SUCCESS

-

-

FAILED

INITIALIZED

-

BUSY

PENDING

OPENING

-

BUSY

OPENED

-

BUSY

PENDING

SUCCESS

STARTACQUISITION

-

BUSY