Isavi_Initevent - THORLABS DCU223x Operation Manual And Sdk

DCx Cameras

4.4.13 isavi_InitEvent

USB 2.0
USB 3.0
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
nAviID
which
IS_AVI_SET_EVENT_FRAME_SAVED
Return values
IS_AVI_NO_ERR
IS_AVI_ERR_INVALID_ID
IS_AVI_ERR_EVENT_FAILED
IS_AVI_ERR_PARAMETER
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,
{
//Frame was captured successfully...
}
isavi_DisableEvent( AviDest, IS_AVI_SET_EVENT_FRAME_SAVED );
isavi_ExitEvent( AviDest, IS_AVI_SET_EVENT_FRAME_SAVED );
}
370
-
.
361
Instance ID set by the
Name of the event to be created.
A new frame was saved to the AVI file.
363
361
360
1000 ) == WAIT_OBJECT_0 )
isavi_InitAVI()
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.
"" );
function.
369
.
362
© 2013 Thorlabs GmbH