Please enable JavaScript to view this site.

IDS Software Suite - obsolete functions 4.97

Windows_Logo
Linux_Logo

USB 2.0

USB 3.x

GigE

-

Syntax

INT is_InitEvent (HIDS hCam, HANDLE hEv, INT which)

Description

hint_info

This function is obsolete and should not be used anymore. We recommend to use the is_Event() function instead.

is_InitEvent() initializes the event handle for the specified event object. This registers the event object in the uEye kernel driver.

Input parameters

hCam

Camera handle

hEv

Event handle created by the CreateEvent() Windows API function.

which

ID of the event to be initialized (see is_EnableEvent())

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_EnableEvent()

is_DisableEvent()

is_ExitEvent()

Example

HANDLE hEvent = CreateEvent(NULL, FALSE, FALSE, NULL);
 
//Enable frame event, start image capture and wait for event
is_InitEvent(hCam, hEvent, IS_SET_EVENT_FRAME);
is_EnableEvent(hCam, IS_SET_EVENT_FRAME);
is_FreezeVideo(hCam, IS_DONT_WAIT);
DWORD dwRet = WaitForSingleObject(hEvent, 1000);
if (dwRet == WAIT_TIMEOUT)
{
  /* wait timed out */
}
else if (dwRet == WAIT_OBJECT_0)
{
  /* event signaled */
}
is_DisableEvent(hCam, IS_SET_EVENT_FRAME);
is_ExitEvent(hCam, IS_SET_EVENT_FRAME);
CloseHandle(hEvent);