List of TeliCamSDK Status Code | |||
---|---|---|---|
CAM_API_STATUS | Value | Description | Details |
CAM_API_STS_SUCCESS | 0x00000000 | It succeeded. | - |
CAM_API_STS_NOT_INITIALIZED | 0x00000001 | The initialization for API has never been performed. | Sys_Initialized() is not called. |
CAM_API_STS_ALREADY_INITIALIZED | 0x00000002 | The initialization for API has already been performed. | Sys_Initialized() is called more than two times. |
CAM_API_STS_NOT_FOUND | 0x00000003 | API detected no cameras. | ・ Camera is not connected. ・ Camera failure. ・ Cable failure. |
CAM_API_STS_ALREADY_OPENED | 0x00000004 | Camera or the other object has been already opened. | ・Open the same object(camera/stream/event) more than two times. ・Open the same object already opened by other application. |
CAM_API_STS_ALREADY_ACTIVATED | 0x00000005 | Camera or the other object has been already activated. | - |
CAM_API_STS_INVALID_CAMERA_INDEX | 0x00000006 | The specified camera index is invalid. | Input invalid camera index. |
CAM_API_STS_INVALID_CAMERA_HANDLE | 0x00000007 | The specified camera handle is invalid. | ・Input invalid node handle. ・After disconnected the camera. |
CAM_API_STS_INVALID_NODE_HANDLE | 0x00000008 | The specified node handle is invalid. | Input invalid node handle. |
CAM_API_STS_INVALID_STREAM_HANDLE | 0x00000009 | The specified stream handle is invalid. | Input invalid stream handle. |
CAM_API_STS_INVALID_REQUEST_HANDLE | 0x0000000A | The specified request handle is invalid. | Input invalid request handle. |
CAM_API_STS_INVALID_EVENT_HANDLE | 0x0000000B | The specified event handle is invalid. | Input invalid event handle. |
CAM_API_STS_INVALID_PARAMETER | 0x0000000D | The specified parameter is invalid. | Input invalid parameter. |
CAM_API_STS_BUFFER_TO_SMALL | 0x0000000E | The specified buffer is too small. | Buffer size is not enough. |
CAM_API_STS_NO_MEMORY | 0x0000000F | To allocate internal buffer of API is unsuccessful. | PC Memory is not enough. [Measures] ・ Add more memory. ・ Change to 64bit OS (if it's 32bit OS). ・ Decrease the number of internal ImageRingBuffer in TeliCamSDK(uiApiBufferCount in StrmOpenSimple). ・ Set smaller ROI. |
CAM_API_STS_MEMORY_NO_ACCESS | 0x00000010 | To access to the specified buffer is unsuccessful. | The application cannot access the memory. The cause is in the PC side. |
CAM_API_STS_NOT_IMPLEMENTED | 0x00000011 | Feature is not implemented in the camera or API. This status may be also returned when wrong register name or node name is used. | ・ Feature is not implemented in the camera. ・ Feature is not implemented in API. ・ The register name is wrong. ・ The node name is wrong. |
CAM_API_STS_TIMEOUT | 0x00000012 | The timeout occurred. | Timeout occurrs in read or write register access to camera. |
CAM_API_STS_CAMERA_NOT_RESPONDING | 0x00000013 | The specified camera does not send response. The cable which has connected the camera may have separated. Please check the connection. | ・ Camera is not connected. ・ Some trouble occurrs in host controller. [Measures] If the USB selective suspend setting of Windows is enable, setting it to disable can be a solution. |
CAM_API_STS_EMPTY_COMPLETE_QUEUE | 0x00000014 | The request in the Complete Queue is empty. | This status is returned by calling Strm_DequeueRequest() or Evt_DequeueRequest() when the complete queue is empty. This status is also returned when it's not error case. |
CAM_API_STS_NOT_READY | 0x00000015 | The target is not ready state. | - |
CAM_API_STS_ACCESS_MODE_SET_ERR | 0x00000016 | Api failed to set access mode of the camera. | - |
CAM_API_STS_INSUFFICIENT_BUFFER_NUM | 0x00000017 | Insufficient number of buffers. | - |
CAM_API_STS_IO_DEVICE_ERROR | 0x00000020 | Controller caused an I/O error. | This error is returned when some error occrrs in host controller. ・ Camera is connected by USB2.0. ・ Host controller quarity is not good. ・ Cable quarity is not good. ・ Not supplying power to USB card. |
CAM_API_STS_LOGICAL_PARAM_ERROR | 0x00000021 | Passed parameters have logical error(s). | Added from TeliCamSDK v3.0.0.1. This error is returned on Dual USB camera only. This error inditaces the occurrence of mismatch in payload size(primary, secondary and total). |
CAM_API_STS_NOT_CONNECTED_TO_USB3 | 0x00000030 | The camera is connected by something other than USB3. | - |
CAM_API_STS_XML_LOAD_ERR | 0x00000101 | Api failed to load XML file (camera description file). | This error is returned from Cam_Open() when GenICam GenApi library failed to load camera information. ・ There is no GenICam dll file. ・ There is no Microsoft VC++ Runtime in the PC. ・ Environmental valuables for GenICam dll is not set. ・ Failure of camera. ・ Unstable USB communication. [Measures] Reinstall of TeliCamSDK. [Reference] https://www.toshiba-teli.co.jp/pdf/technology/faq/f0007_XmlLoadError.pdf |
CAM_API_STS_GENICAM_ERR | 0x00000102 | Error occurred in GenApi. | The details of the error can be obtained by GenApi_GetLastError() function. |
CAM_API_STS_DLL_LOAD_ERR | 0x00000103 | Api failed to load shared object files. | High level dll(e.g. TeliCamApi64.dll) cannot load low level dll(e.g. TeliU3vCamApi64.dll, TeliU3vCamApi2_64.dll) for some reason. |
CAM_API_STS_NO_SYSTEM_RESOURCES | 0x000005AA | Insufficient system resources exist to complete the requested service. | This error is returned when the kernel memory is infficient. |
CAM_API_STS_INVALID_ADDRESS | 0x00000801 | The specified addres is invalid. | The address is out of range. |
CAM_API_STS_WRITE_PROTECT | 0x00000802 | The register is protected from writing data. | This error is returned when accessing to write a register which has write protection(e.g. Read only register of USB3VisionABRM/USB3VisionSBRM/USB3VisionSIRM/USB3VisionEIRM). |
CAM_API_STS_BAD_ALIGNMENT | 0x00000803 | The address is not aligned to specified boundary. | The address is not a multiple of 4. |
CAM_API_STS_ACCESS_DENIED | 0x00000804 | Accessing data was denied. User application may not have access privilege. | - |
CAM_API_STS_BUSY | 0x00000805 | The camera is in busy state. Try again after a while. | - |
CAM_API_STS_NOT_READABLE | 0x00000806 | The target is not readable. | This error is retuened when the application attempts to read Write-Only register. |
CAM_API_STS_NOT_WRITABLE | 0x00000807 | The target is not writable. | ・ This error is retuened when the application attempts to write Read-Only register. ・ Access to register in prohibited period. |
CAM_API_STS_NOT_AVAILABLE | 0x00000808 | The function or parameter is not available. The controlling camera feature functions that use GenICam GenApi function are not available when GenApi module was disabled on opening the camera. | - |
CAM_API_STS_VERIFY_ERR | 0x00000809 | A verify error occurred when data was written to the camera registers. | When the application writes register by Controlling camrea feature functions, TeliCamAPI verifies to the register. If the read value after writing differs from wrote value, this error will be returned. |
CAM_API_STS_REQUEST_TIMEOUT | 0x00001001 | Timeout occurred in requesting stream or event. | Timeout occurrs in USB communication(stream or event access). It tends to occurr when USB communication is unstable. |
CAM_API_STS_RESEND_TIMEOUT | 0x00001002 | The StreamRequests coud not be completed in time after the first packet was received. (only in GigE camera) | ・ Some trouble occurrs in GigE communication. ・ Failure of camera. |
CAM_API_STS_RESPONSE_TIMEOUT | 0x00001003 | The next packet could not be received in time after somepacket was received. (Only in GigE camera) | ・ Some trouble occurrs in GigE communication. ・ Bandwidth of the network is not be enough. ・ Failure of camera. |
CAM_API_STS_BUFFER_FULL | 0x00001004 | The received data size exceeded maximum size specified. | ・ Lost Trailer packet of USB3 Vision. ・ Chage ROI size without calling Strm_Close(). ・ Buffer size in Strm_Open is smaller than that of actual ROI size(only in low level API function). ・ Insufficient performance of NIC(only in GigE camera). |
CAM_API_STS_UNEXPECTED_BUFFER_SIZE | 0x00001005 | The data size actually received was different from the size described in the trailer. | Unstable USB communication. |
CAM_API_STS_UNEXPECTED_NUMBER | 0x00001006 | The received packet count exceeded the maximum. | - |
CAM_API_STS_PACKET_STATUS_ERROR | 0x00001007 | The packet returned error status. | This error shows the status of trailer packet is error. |
CAM_API_STS_RESEND_NOT_IMPLEMENTED | 0x00001008 | Resend command is not implemented in the camera. | The camera doesn't support Packet Resend command in GigE camera. |
CAM_API_STS_PACKET_UNAVAILABLE | 0x00001009 | The packet is unavailable. | This error is returned from camera when the camera cannot resend the packet for Packet Resend(only in GigE camera). |
CAM_API_STS_MISSING_PACKETS | 0x0000100A | A leader of the next block has been received before the completion of a frame data. Packets may be lost. | ・ Unstable USB commnication. ・ External noise. |
CAM_API_STS_FLUSH_REQUESTED | 0x0000100B | The request was flushed by the user. | This status is returned in Strm_DequeueRequest() after called Strm_FlushWaitQueue(). This status is also returned when it's not error case. |
CAM_API_STS_TOO_MANY_PACKET_MISSING | 0x0000100C | The loss of packet exceeded the specified value (default:20). In GigE camera case, band width of the network may not be enough for sending images in current settings. Enabling Jumbo-Packet or restrictimg frame rate will be required. | - |
CAM_API_STS_FLUSHED_BY_D0EXIT | 0x0000100D | The request was flushed due to a change of the power state. | - |
CAM_API_STS_FLUSHED_BY_CAMERA_REMOVE | 0x0000100E | The request was flushed due to a disconnection with the camera. | - |
CAM_API_STS_DRIVER_LOAD_ERR | 0x0000100F | Api failed to load Driver. | Teli driver is not installed correctly. |
CAM_API_STS_MAPPING_ERROR | 0x00001010 | Mapping user buffer to system-space virtual address is failed. It may be caused by low system resources. | Added from TeliCamSDK v3.0.0.1. [Measures] ・ Add more memory. ・ Change to 64bit OS (if it's 32bit OS). |
CAM_API_STS_FILE_OPEN_ERROR | 0x00002001 | Api failed to open file. | This error is only returned by file control functions(e.g. SaveBmp*()). |
CAM_API_STS_FILE_WRITE_ERROR | 0x00002002 | Api failed to write data in file. | This error is only returned by file control functions(e.g. SaveBmp*()). |
CAM_API_STS_FILE_READ_ERROR | 0x00002003 | Api failed to read data from file. | This error is only returned by file control functions(e.g. SaveBmp*()). |
CAM_API_STS_FILE_NOT_FOUND | 0x00002004 | The specified file was not found. | This error is only returned by file control functions(e.g. SaveBmp*()). |
CAM_API_STS_INVALID_PARAMETER_FROM_CAM | 0x00008002 | Invalid parameter error was returned from the camera. | - |
CAM_API_STS_SI_PAYLOAD_SIZE_NOT_ALIGNED | 0x0000A003 | The value written to the SI streaming size registers is not aligned to Payload Size Alignment value of the SI Info register. | - |
CAM_API_STS_DATA_DISCARDED | 0x0000A100 | Some data in the block has been discarded. | This error is returned from camera through trailer packet. ・ After AcquisitionAbort() called(firmware version Ver.4.0.8 or later). ・ Unstable USB commnication of USB3 Vision. |
CAM_API_STS_DATA_OVERRUN | 0x0000A101 | The camera cannot send all data because the data does not fit within the programmed SIRM register settings. | This error is returned from camera through trailer packet. ・ After AcquisitionAbort() called(firmware version Ver.4.0.7 or earlier). ・ Unstable USB commnication of USB3 Vision. |
CAM_API_STS_OUT_OF_MEMORY | 0x0000C000 | The system and/or other hardware in the system(Framegrabber) ran out of memory. | Added from TeliCamSDK v4.0.1.1. |
CAM_API_STS_U3V_NOT_AVAILABLE | 0x10000001 | Failed to load U3V DLL. (Warning) Interfaces other than USB3 are available. | Added from TeliCamSDK v4.0.1.1. |
CAM_API_STS_GEV_NOT_AVAILABLE | 0x10000002 | Failed to load GEV DLL. (Warning) Interfaces other than GigE are available. | Added from TeliCamSDK v4.0.1.1. |
CAM_API_STS_GENTL_NOT_AVAILABLE | 0x10000004 | Failed to load GenTL DLL. (Warning) Interfaces other than GenTL are available. | Added from TeliCamSDK v4.0.1.1. |
CAM_API_STS_UNSUCCESSFUL | 0xFFFFFFFF | The other error occurred. | ・ Check wthether another error happens at the same time. ・ This error may change to another error by updating TeliCamSDK to later version. |