IDS Software Suite 4.96.1

Syntax

INT is_GetError (HIDS hCam, INT* pErr, IS_CHAR** ppcErr)

Description

is_GetError() queries the last error that occurred and returns the associated error code and message. It is recommended to call this function after the previous function has returned the error IS_NO_SUCCESS. Each error message will be overwritten when a new error occurs.

Input parameters

Return values

Related functions

•is_CaptureStatus()

•is_SetErrorReport()

•is_CameraStatus()

Example

HIDS hCam; // Already initialized camera handle
INT newPixelClock = 0;
INT nRet = IS_NO_SUCCESS;
const unsigned short bufferLen = 128;
char myErrorBuffer[bufferLen]; // You can also allocate the string dynamically
// Will cause error because pixel clock 0 does not exist
nRet = is_PixelClock(hCam, IS_PIXELCLOCK_CMD_SET, &newPixelClock, sizeof(newPixelClock));
if(nRet != IS_SUCCESS)
{
  INT lastError;
 
  // DO NOT allocate this buffer yourself, otherwise it will be overwritten.
  // DO NOT free this buffer
  // The internal buffer is overwritten when another API function fails, so make sure to copy this string to your own buffer.
  char* lastErrorString;
 
  nRet = is_GetError(hCam, &lastError, &lastErrorString);
  if(nRet == IS_SUCCESS)
  {
      // Copy the temporary string to our own buffer
      memset(myErrorBuffer, 0, bufferLen);
      strncpy(myErrorBuffer, lastErrorString, bufferLen);
      lastErrorString = 0;
  }
}