Teledyne Princeton Instruments PICam 5.x, Руководство программиста

Страница: 187 / 357

Chapter 6 Data Acquisition APIs 187
6.4.2
Picam_StartAcquisition()
Description
Picam_StartAcquisition()
asynchronously initiates data acquisition and returns
immediately.
NOTE:
Parameters must be committed prior to initiating data
acquisition. Refer to
Section 5.4.6.2,
Picam_CommitParameters() , on page 179 for information.
On success, data acquisition is running and continues until:
• The number of readouts specified by
PicamParameter_ReadoutCount
have
been acquired;
• An error occurs which immediately halts data acquisition (refer to Section 6.4.1,
Picam_Acquire() , on page 185 for additional information); or
•
Picam_StopAcquisition()
is called, in which case the acquisition will stop
asynchronously (i.e., sometime in the future after this function returns.)
NOTE:
To determine the current data acquisition status, call
Picam_WaitForAcquisitionUpdate() .
Syntax
The syntax for Picam_StartAcquisition() is:
PICAM_API Picam_StartAcquisition(
PicamHandle camera);
Input Parameters
Input parameters for Picam_StartAcquisition() are:
Output Parameters
There are no output parameters associated with
Picam_StartAcquisition()
.
Advanced API Usage
When used in conjunction with Advanced APIs, if
PicamParameter_ReadoutCount
=
0, the hardware will run continuously until
Picam_StopAcquisition()
is called to
stop asynchronously.
Related APIs
For additional information, refer to the following related APIs:
• Picam_CommitParameters() ;
• Picam_Acquire() ;
• Picam_StopAcquisition() ;
• Picam_WaitForAcquisitionUpdate() .
camera:
Handle for the hardware for which data acquisition is to be initiated.