uEye Camera Manual Version 4.92
 |
 |
USB 2.0 USB 3.0 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 );
}
Suggestion for improvement? Send us your short
Feedback on this chapter.
Thank you very much!
For technical questions please contact your local distributor or use the support form on our website.