CreateSequence (DVR version only)
Top  Previous  Next

Description

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


Syntax


[VB]
objActiveUSB.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()

ActiveUSB1.CreateSequence 1000

ActiveUSB1.Acquire = True

End Sub


Private Sub
StartButton_Click()
ActiveUSB1.StartSequenceCapture 800

End Sub


Private Sub
StopButton_Click()
ActiveUSB1.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.