Please enable JavaScript to view this site.

uEye DirectShow 4.97

Syntax

EnableEvent (INT nWhich)

Description

Enables an event object. After the release the event messages for the created event object are enabled. Depending on the operating system different functions are to call.

Event has to be provided by the application program

Event has to be declared by InitEvent

Event has to be enabled by EnableEvent

You have to wait for the event in the application program by WaitForSingleObject or WaitForMultipleObject

Event has to be disabled by DisableEvent

Event has to be deleted by ExitEvent

hint_info

Event handling for images

If you use the event handling to signal new images from the camera, it may occur under high system load that the event-based application does not receive a signal for every image. This is because the event concept does not provide that several events of the same type are stored. If due to system load more than one image is signaled before the application is ready (e.g. WaitForSingleObject), you have no option to capture these missed events.

Parameter

nWhich

IS_SET_EVENT_AUTOBRIGHTNESS_FINISHED
The automatic brightness control in the run-once mode is completed.

IS_SET_EVENT_AUTOFOCUS_FINISHED
Automatic focus control is finished (XS only).

IS_SET_EVENT_CAMERA_MEMORY
In the camera memory mode an image acquisition iteration is finished.

IS_SET_EVENT_CAPTURE_STATUS
There is a information about image capturing available.

IS_SET_EVENT_CONNECTIONSPEED_CHANGED
The connection speed of a USB 3 uEye camera changed from USB 2.0 to USB 3.0 or from USB 3.0 to USB 2.0.

IS_SET_EVENT_DEVICE_PLUGGED_IN
An already paired GigE uEye camera was reconnected to the network (Requirement: the camera is operated in trusted pairing mode).

IS_SET_EVENT_DEVICE_UNPLUGGED
A paired GigE uEye camera was disconnected from the network (Requirement: the camera is operated in trusted pairing mode).

IS_SET_EVENT_DEVICE_RECONNECTED
An initialized and disconnected afterwards camera was reconnected.

IS_SET_EVENT_EXTTRIG
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 will be available after the IS_FRAME processing event.

IS_SET_EVENT_FIRST_PACKET_RECEIVED
The first data packet of the image was transferred to the PC. This is the earliest time for determining if the image exposure is finished.

IS_SET_EVENT_FRAME
A new image is available.

IS_SET_EVENT_NEW_DEVICE
A new camera was connected.

IS_SET_EVENT_OVERLAY_DATA_LOST
Direct3D mode: Because of a re-programming the parameters of the overlay are invalid. The overlay must be draw new.

IS_SET_EVENT_PMC_IMAGE_PARAMS_CHANGED
Multicast mode: The master has changed camera parameters which affect the data format like image size or color format. The client must reconfigure the virtual camera.

IS_SET_EVENT_REMOVAL
A camera was removed.

IS_SET_EVENT_REMOVE
An initialized camera was disconnected.

IS_SET_EVENT_SEQ
The sequence is completed.

IS_SET_EVENT_STEAL
An image extracted from the overlay is available.

IS_SET_EVENT_TEMPERATURE_STATUS
USB 3 uEye CP Rev. 2 only: The temperature state of the camera has changed.

IS_SET_EVENT_WB_FINISHED
The automatic white balance control is completed.

Interface

InitEvent

Related functions

InitEvent

DisableEvent