THORLABS DCU223 SERIES Description And Sdk Manual

© 2016 Thorlabs Scientific Imaging406
DCx Camera Functional Description and SDK Manual
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
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
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
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 );
}

THORLABS DCU223 SERIES Specifications

General

Brand	THORLABS
Model	DCU223 SERIES
Category	Security Camera
Language	English