 |
 |
|---|---|
USB 2.0 USB 3.x GigE |
USB 2.0 USB 3.x GigE |
Syntax
INT is_LockSeqBuf (HIDS hCam, INT nMemId, char* pcMem)
Beschreibung
is_LockSeqBuf() sperrt den Schreibzugriff auf einen Bildspeicher einer Sequenz. Ein gelockter Bildspeicher wird in der Sequenzliste der zu verwendenden Bildspeicher bei der Aufnahme übersprungen. Damit kann verhindert werden, dass Bilddaten, die noch zur weiteren Verarbeitung benötigt werden, durch neue Daten überschrieben werden. Es können beliebig viele Bildspeicher gleichzeitig gesperrt werden.
|
Während des Schreibens von Bilddaten in einen Bildspeicher durch den Treiber schlägt ein Aufruf von is_LockSeqBuf() für diesen Bildspeicher fehl. Daher wird dringend empfohlen, das erfolgreiche Sperren durch is_LockSeqBuf() anhand des Rückgabewerts der Funktion zu überprüfen. |
Mit is_UnlockSeqBuf() wird ein Bildspeicher wieder für den Schreibzugriff freigegeben.
|
Zu jedem erfolgreichen Aufruf von is_LockSeqBuf() muss ein Aufruf von is_UnlockSeqBuf() erfolgen! |
Übergabeparameter
hCam |
Handle auf Kamera |
nMemId |
Nummer des Bildspeichers, der geschützt werden soll (1…max) oder IS_IGNORE_PARAMETER: Der Bildspeicher wird nur anhand der Startadresse identifiziert. |
pcMem |
Startadresse des Bildspeichers, der geschützt werden soll |
|
nMemId bezeichnet die Position in der Sequenzliste, nicht die mit is_AllocImageMem() vergebene Speicher-ID. |
nMemId |
pcMem |
Sperren anhand von |
valid |
valid |
pcMem |
valid |
NULL |
nMemId |
IGNORE |
valid |
pcMem |
IGNORE |
NULL |
Fehler |
Rückgabewert
IS_BAD_STRUCTURE_SIZE |
Eine interne Struktur hat die falsche Größe. |
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_SEQ_BUFFER_IS_LOCKED |
Der Bildspeicher ist gesperrt. |
IS_SUCCESS |
Funktion erfolgreich |
Verwandte Funktionen
