is_LockSeqBuf

USB 2.0

USB 3.0

GigE

USB 2.0

USB 3.0

GigE

Syntax

INT is_LockSeqBuf (HIDS hCam, INT nNum, 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
nNum	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

nNum bezeichnet die Position in der Sequenzliste, nicht die mit is_AllocImageMem() vergebene Speicher-ID.

nNum	pcMem	Sperren anhand von
valid	valid	pcMem
valid	NULL	nNum
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

•is_UnlockSeqBuf()

•is_AddToSequence()

•is_SetImageMem()

•is_SetAllocatedImageMem()

Haben Sie Verbesserungshinweise? Senden Sie ein kurzes Feedback zu diesem Kapitel. Vielen Dank!
Bei technischen Fragen wenden Sie sich bitte an Ihren lokalen Händler oder nutzen Sie das Support-Formular auf unserer Internetseite.