IDS Software Suite 4.96.1
 |
 |
|---|---|
USB 2.0 USB 3.x GigE |
- |
Syntax
INT isavi_InitEvent (INT nAviID, INT which)
Description
isavi_InitEvent() creates the specified event. This includes registering the event object in the uEye AVI interface and creating an event handler. Before you can use a new event, you must enable it by calling isavi_EnableEvent().
Input parameters
nAviID |
Instance ID set by the isavi_InitAVI() function. |
which |
Name of the event to be created. |
IS_AVI_SET_EVENT_FRAME_SAVED |
A new frame was saved to the AVI file. |
Return values
IS_AVI_NO_ERR |
No error, function executed successfully. |
IS_AVI_ERR_INVALID_ID |
The indicated AVI instance could not be found. Either the AVI ID is invalid or the instance has already been deleted using isavi_ExitAVI(). |
IS_AVI_ERR_EVENT_FAILED |
The event could not be initialized. The Windows SetEvent function failed. |
IS_AVI_ERR_PARAMETER |
One of the submitted parameters is outside the valid range. |
Related functions
Example
Create and enable an event object for the "Frame saved" event:
HANDLE hEvent = CreateEvent( NULL, TRUE, FALSE, "" );
if ( hEvent != NULL )
{
isavi_InitEvent( AviDest, hEvent, IS_AVI_SET_EVENT_FRAME_SAVED );
isavi_EnableEvent( AviDest, IS_AVI_SET_EVENT_FRAME_SAVED );
if ( WaitForSingleObject( hEvent, 1000 ) == WAIT_OBJECT_0 )
{
//Frame was captured successfully...
}
isavi_DisableEvent( AviDest, IS_AVI_SET_EVENT_FRAME_SAVED );
isavi_ExitEvent( AviDest, IS_AVI_SET_EVENT_FRAME_SAVED );
}
