© 2016 Thorlabs Scientific Imaging
4 Programming (SDK)
195
4.3.22 is_EnableMessage
Syntax
INT is_EnableMessage (HIDS hCam, INT which, HWND hWnd)
Description
Using is_EnableMessage(), you can enable Windows messages. If a particular event occurs, the
messages are sent to the application.
Each message is structured as follows:
Message: IS_uc480_MESSAGE
wParam: Event (see table)
lParam: DCx camera handle associated with the message
Attention
You have to deactivate Windows messages with hWnd == NULL before you free the uc480 API
library. Otherwise the application may not close properly.
Input parameters
which: ID of the message to be enabled/disabled
A new image is available.
The sequence is completed.
An error occurred during the data transfer, see
is_CaptureStatus().
The parameter IS_CAPTURE_STATUS replaces the
previous parameter IS_TRANSFER_FAILED.
The parameter IS_TRANSFER_FAILED was
moved into the new header file
uc480_deprecated.h, which contains all
obsolete function definitions and constants. If
necessary the header file uc480_deprecated.h
can be included in addition to the header file
uc480.h.
An image which was captured following the
arrival of a trigger has been transferred
completely.
This is the earliest possible moment for a new
capturing process. The image must then be
post-processed by the driver and is available
after the IS_FRAME message has occurred.
A camera initialized with is_InitCamera() was
disconnected.
A camera initialized with is_InitCamera() and
disconnected afterwards was reconnected.