THORLABS DCU223 SERIES User Manual

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

THORLABS DCU223 SERIES Specifications

General

Brand	THORLABS
Model	DCU223 SERIES
Category	Security Camera
Language	English