USB 2.0 USB 3.0 GigE	USB 2.0 USB 3.0 GigE

Syntax

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

Beschreibung

is_GetError() fragt den letzten aufgetretenen Fehler ab und liefert Fehlercode und Fehlermeldung zurück. Es wird empfohlen, diese Funktion aufzurufen, nachdem die vorherige Funktion den Fehler IS_NO_SUCCESS zurückgeliefert hat. Eine Fehlermeldung wird durch neu eintretende Fehler überschrieben.

Übergabeparameter

Rückgabewert

Verwandte Funktionen

•is_CaptureStatus()

•is_SetErrorReport()

•is_CameraStatus()

Beispiel

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 pixelclock 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;
  }
}