Syntax
INT is_GetActSeqBuf (HIDS hf, INT* pnNum, char** ppcMem, char** ppcMemLast);
Description
With is_GetActSeqBuf() the image memory in which image acquisition (ppcMem) is currently taking place (or the image memory which was last used for image acquisition (ppcMemLast)) can be determined. This function is only available when the ring buffer is active. If image acquisition is started for a ring buffer, is_GetActSeqBuf() returns 0 in pnNum as long as data is acquired to the first image memory of the sequence. And thus pnNum receives the number of the sequence image memory, in which image acquisition is currently taking place. The number is not the ID of the image memory which is provided from is_AllocImageMem(), but the running number in the sequence as defined in is_AddToSequence().
If video signal is missing, the value of pnNum is zero and the sequence stops. To start the sequence again, you have to call the functions is_StopLiveVideo() and is_CaptureVideo(). Then the sequence starts as described above.
|
Attention: If the video signal is lost, the IS_SET_EVENT_SEQ event is still set. |
Parameters
hf |
Frame grabber handle |
pnNum |
Contains the number of the image memory in which image acquisition is currently taking place. •0: image acquisition has not started in the first image memory •1 to max: image acquisition in the sequence image memory N has started. |
ppcMem |
Contains the start address of the image memory in which the current image acquisition is taking place. |
ppcMemLast |
Contains the start address of the image memory, which was last used for image acquisition. |
Return value
IS_SUCCESS, IS_NO_SUCCESS
