Is_Initcamera - THORLABS DCU223x Operation Manual And Sdk

4.3.60 is_InitCamera

USB 2.0
USB 3.0
Syntax
INT is_InitCamera (HIDS* phf, HWND hWnd)
Description
is_InitCamera() starts the driver and establishes the connection to the camera. After successful initialization,
this function assigns the camera handle. All subsequent functions require this handle as the first parameter.
When using Direct3D or OpenGL for image display, you can pass a handle to the output window.
Notes
1. Multi-camera environments
When using multiple cameras in parallel operation on a single system, you should assign a unique camera ID to
each camera. To initialize or select a camera with is_InitCamera(), the phCam handle must previously have
been set to the desired camera ID.
To initialize or select the next available camera without specifying a camera ID, phCam has to be preset with 0.
2. Thread safety
We recommend that you call the following functions exclusively from a single thread in order to avoid unpredictable
behavior of the application.
is_InitCamera()
is_SetDisplayMode()
is_ExitCamera()
See also General: Thread programming
Input parameters
phCam
*phCam |
IS_USE_DEVICE_ID
*phCam |
IS_ALLOW_STARTER_FW_UPLOAD
hWnd
Return values
IS_ALL_DEVICES_BUSY
IS_BAD_STRUCTURE_SIZE
IS_CANT_ADD_TO_SEQUENCE
© 2013 Thorlabs GmbH
USB 2.0
USB 3.0
273
322
213
453
Pointer to the camera handle
When you call this function, the pointer value has the following
meaning:
0: The first available camera will be initialized or selected.
1-254: The camera with the specified camera ID will be initialized or
selected.
The camera is opened using the device ID instead of the camera
ID. For details on device ID please refer to the
is_GetCameraList()
During initialization of the camera, this parameter checks whether a
new version of the starter firmware is required. If it is, the new
starter firmware is updated automatically (only GigE uEye SE/RE/
CP cameras).
To ensure backward compatibility of applications, always call
is_InitCamera() without the IS_ALLOW_STARTER_FW_UPLOAD
parameter first. Only if an error occurs, call the function with this
parameter set (see
Pointer to the window where the Direct3D image will be displayed
If hWnd = NULL, DIB mode will be used for image display.
chapter.
233
Example below).
275
All cameras are in use
An internal structure has an incorrect size.
The image memory is already included in the sequence
and cannot be added again.
4 Programming (SDK)
273