Home > C: Programming > Function descriptions > History back  Previous chapter  Next chapter  Print  

is_EnableMessage

uEye Camera Manual Version 4.00

is_EnableMessage

Windows_Logo

Linux_Logo

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

Achtung

You have to deactivate Windows messages with hWnd == NULL before you free the uEye API library. Otherwise the application may not close properly.

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

is_InitEvent()


Suggestion for improvement? Send us your short Feedback on this chapter. Thank you very much!

For technical questions please contact you local distributor or use the support form on our website.


© 2012 IDS Imaging Development Systems GmbH
http://www.ids-imaging.com