| Home > C: Programming > Function descriptions > | History back Previous chapter Next chapter Print |
is_EnableMessage |
|
uEye Camera Manual Version 4.00
|
|
USB 2.0 USB 3.0 GigE |
- |
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_UEYE_MESSAGE
•wParam: Event (see table)
•lParam: uEye camera handle associated with the message
|
|
Input parameters
hCam |
Camera handle |
which |
ID of the message to be enabled/disabled |
IS_FRAME |
A new image is available. |
IS_SEQUENCE |
The sequence is completed. |
IS_CAPTURE_STATUS |
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 ueye_deprecated.h, which contains all obsolete function definitions and constants. If necessary the header file ueye_deprecated.h can be included in addition to the header file ueye.h. |
IS_TRIGGER |
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. |
IS_DEVICE_REMOVED |
A camera initialized with is_InitCamera() was disconnected. |
IS_DEVICE_RECONNECTED |
A camera initialized with is_InitCamera() and disconnected afterwards was reconnected. |
IS_NEW_DEVICE |
A new camera was connected. |
IS_DEVICE_REMOVAL |
A camera was removed. |
IS_WB_FINISHED |
Automatic white balance control is completed (only if this control was started using the IS_SET_AUTO_WB_ONCE function). |
IS_AUTOBRIGHTNESS_FINISHED |
Automatic brightness control is completed (only if this control was started using the IS_SET_AUTO_BRIGHTNESS_ONCE function). |
hWnd |
Application window for receiving the message. NULL disables the message designated by the which parameter. |
Return values
IS_INVALID_CAMERA_HANDLE |
Invalid camera handle |
IS_INVALID_PARAMETER |
One of the submitted parameters is outside the valid range or is not supported for this sensor or is not available in this mode. |
IS_NO_SUCCESS |
General error message |
IS_SUCCESS |
Function executed successfully |
Related functions