© 2016 Thorlabs Scientific Imaging406
DCx Camera Functional Description and SDK Manual
4.4.13 isavi_InitEvent
Syntax
INT isavi_InitEvent (INT nAviID, INT which)
Description
isavi_InitEvent() creates the specified event. This includes registering the event object in the
uc480 AVI interface and creating an event handler. Before you can use a new event, you must
enable it by calling isavi_EnableEvent().
Input parameters
Instance ID set by the isavi_InitAVI() function.
Name of the event to be created.
IS_AVI_SET_EVENT_FRAME_SAVED
A new frame was saved to the AVI file.
Return values
Function executed successfully.
The indicated AVI instance could not be found.
Either the AVI ID is invalid or the instance has
already been deleted using isavi_ExitAVI().
The event could not be initialized. The Windows
SetEvent function failed.
One of the submitted parameters is outside the
valid range.
Related functions
isavi_ExitEvent()
isavi_EnableEvent()
isavi_DisableEvent()
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 );
}