 |
 |
|---|---|
USB 2.0 USB 3.x GigE |
USB 2.0 USB 3.x 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
hCam |
Handle auf Kamera |
pErr |
Zeiger auf Variable, die den Fehlercode aufnimmt |
ppcErr |
Zeiger auf String, der den Fehlertext aufnimmt |
Rückgabewert
IS_INVALID_CAMERA_HANDLE |
Ungültiges Kamera-Handle |
IS_INVALID_PARAMETER |
Einer der übergebenen Parameter ist außerhalb des gültigen Bereichs, oder für diesen Sensor nicht unterstützt, bzw. in diesem Modus nicht zugänglich. |
IS_NO_SUCCESS |
Allgemeine Fehlermeldung |
IS_SUCCESS |
Funktion erfolgreich |
Verwandte Funktionen
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;
}
}
