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

is_EnableMessage

uEye Camera Manual Version 3.80

is_EnableMessage

Windows_Logo

Linux_Logo

USB 2.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_TRANSFER_FAILED

An error occurred during the data transfer.

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_SUCCESS

Function executed successfully

IS_NO_SUCCESS

General error message

Related Functions

is_InitEvent()

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


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