CreateSequence (DVR version only)

Description

Allocates memory for capturing a sequence of frames. Used in combination with StartSequenceCapture and StopSequenceCapture.


Syntax

[VB]
objActiveDcam.CreateSequence Frames

[C/C++]
HRESULT CreateSequence( long Frames);


Data Types [VB]

Frames : long

Parameters [C/C++]

Frames [in]

The maximum number of frames to be allocated for the memory sequence.

Return Values

S_OK

Success

E_FAIL

Failure.

E_OUTOFMEMORY

Not enough memory

Example

This VB example demonstrates how to allocate enough memory for the sequence capture:

Private Sub Form_Load()
ActiveDcam1.CreateSequence 1000
ActiveDcam1.Acquire = True
End Sub

Private Sub StartButton_Click()
ActiveDcam1.StartSequenceCapture 800
End Sub

Private Sub StopButton_Click()
ActiveDcam1.StopSequenceCapture
End Sub


Remarks

Using this method allows you to avoid an unnecessary delay when calling StartSequenceCapture. If enough memory has been allocated with CreateSequence, the StartSequenceCapture will start acquiring frames into the memory immediately after being called.

The amount of memory allocated with CreateSequence must not exceed the limit allowed for an application in your operating system. Such an amount is typically limited to 2 GB for a 32-bit version of Windows. If you use Windows 64-bit, it is recommended to keep the amount of allocated memory below the physical size of RAM in order to avoid the use of the virtual (hard-drive) space.

If the amount of memory you try to allocate exceeds the limit allowed for your application, this method will return an error.