© 2013 Thorlabs GmbH370
DCx Cameras
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 );
}
361
369
362
363
361
360