User`s guide

FUNCTIONS
SDK SECTION 11
Page 260
WaitForAcquisition
unsigned int WINAPI WaitForAcquisition(void)
Description
WaitForAcquisition can be called after an acquisition is started using
StartAcquisition to
put the calling thread to sleep until an Acquisition Event occurs. This can be used as a
simple alternative to the functionality provided by the SetDriverEvent function, as all
Event creation and handling is performed internally by the SDK library.
Like the SetDriverEvent functionality it will use less processor resources than
continuously polling with the GetStatus function. If you wish to restart the calling thread
without waiting for an Acquisition event, call the function CancelWait.
An Acquisition Event occurs each time a new image is acquired during an Accumulation,
Kinetic Series or Run-Till-Abort acquisition or at the end of a Single Scan Acquisition.
If a second event occurs before the first one has been acknowledged, the first one will be
ignored. Care should be taken in this case, as you may have to use CancelWait to exit
the function.
Parameters
NONE
Return
unsigned int
DRV_SUCCESS
DRV_NOT_INITIALIZED
DRV_NO_NEW_DATA
Acquisition Event occurred
System not initialized.
Non-Acquisition Event occurred.(e.g. CancelWait ()
called)
See also
StartAcquisition, CancelWait
WaitForAcquisitionByHandle
unsigned int WINAPI WaitForAcquisitionByHandle(long cameraHandle)
Description
Whilst using multiple cameras WaitForAcquisitionByHandle can be called after an
acquisition is started using StartAcquisition to put the calling thread to sleep until an
Acquisition Event occurs. This can be used as a simple alternative to the functionality
provided by the SetDriverEvent function, as all Event creation and handling is performed
internally by the SDK library. Like the SetDriverEvent functionality it will use less
processor resources than continuously polling with the GetStatus function. If you wish to
restart the calling thread without waiting for an Acquisition event, call the function
CancelWait. An Acquisition Event occurs each time a new image is acquired during an
Accumulation, Kinetic Series or Run-Till-Abort acquisition or at the end of a Single Scan
Acquisition.
Parameters
Long cameraHandle: handle of camera to put into wait state.
Return
unsigned int
DRV_SUCCESS
DRV_P1INVALID
Acquisition Event occurred.
Handle not valid.