is_CameraStatus

USB 2.0

USB 3.0

GigE

USB 2.0

USB 3.0

GigE

Syntax

ULONG is_CameraStatus (HIDS hCam, INT nInfo, ULONG ulValue)

Description

Using is_CameraStatus(), you can query and partly set various status information and settings.

Input parameters

hCam

Camera handle

IS_FIFO_OVR_CNT	Number of FIFO overruns. Is increased if image data gets lost because the USB bus is congested.
IS_SEQUENCE_CNT	Returns the sequence count. For is_CaptureVideo(), this parameter is set to 0. Each time the sequence buffer (image counter) changes, the counter is increased by 1.
IS_SEQUENCE_SIZE	Returns the number of sequence buffers.
IS_EXT_TRIGGER_EVENT_CNT	Returns the camera's internal count of external trigger events.
IS_TRIGGER_MISSED	Returns the number of unprocessed trigger signals. Is reset to 0 after each call.
IS_LAST_CAPTURE_ERROR	Returns the last image capture error. For a list of all possible error events, see is_CaptureStatus().
IS_PARAMETER_SET_1	Indicates whether parameter set 1 including camera settings is present on the camera (read-only). See also is_ParameterSet(). Return values: TRUE Parameter set 1 present FALSE Parameter set 1 not present
IS_PARAMETER_SET_2	Indicates whether parameter set 2 including camera settings is present on the camera (read-only). See also is_ParameterSet(). Return values: TRUE Parameter set 2 present FALSE Parameter set 2 not present
IS_STANDBY	Sets the camera to standby mode. Return values: TRUE Camera changes to standby mode FALSE The camera changes to freerun mode
IS_STANDBY_SUPPORTED	Queries whether the camera supports standby mode (read-only). Return values: TRUE The camera supports standby mode FALSE The camera does not support standby mode

IS_GET_STATUS

Returns the information specified by nInfo.

Return values

Only if ulValue = IS_GET_STATUS	Returns the information specified by nInfo
When used with IS_LAST_CAPTURE_ERROR	Returns the last image capture error. For a list of all possible error events, see is_GetCaptureErrorInfo().
IS_BAD_STRUCTURE_SIZE	An internal structure has an incorrect size.
IS_CANT_COMMUNICATE_WITH_DRIVER	Communication with the driver failed because no driver has been loaded.
IS_CANT_OPEN_DEVICE	An attempt to initialize or select the camera failed (no camera connected or initialization error).
IS_INVALID_CAMERA_TYPE	The camera type defined in the .ini file does not match the current camera model.
IS_INVALID_EXPOSURE_TIME	This setting is not available for the currently set exposure time.
IS_INVALID_CAMERA_HANDLE	Invalid camera handle
IS_INVALID_PARAMETER	One of the submitted parameters is outside the valid range or is not supported for this sensor or is not available in this mode.
IS_IO_REQUEST_FAILED	An IO request from the uEye driver failed. Possibly the versions of the ueye_api.dll (API) and the driver file (ueye_usb.sys or ueye_eth.sys) do not match.
IS_NO_SUCCESS	General error message
IS_NOT_CALIBRATED	The camera does not contain any calibration data.
IS_NOT_SUPPORTED	The camera model used here does not support this function or setting.
IS_OUT_OF_MEMORY	No memory could be allocated.
IS_SUCCESS	Function executed successfully
IS_TIMED_OUT	A timeout occurred. An image capturing process could not be terminated within the allowable period.

Related functions

Suggestion for improvement? Send us your short Feedback on this chapter. Thank you very much!

For technical questions please contact you local distributor or use the support form on our website.

Home > C: Programming > Function descriptions >	History back Previous chapter Next chapter Print
is_CameraStatus