Grabs a single frame into the internal memory. If the Display property is enabled, the frame will be automatically displayed in the control window.
Syntax
[VB]
objActiveDcam.Grab [C/C++]
HRESULT Grab();
Parameters
None
Return Values
S_OK
Success
E_ABORT
Timeout occured
E_NOINTERFACE
Camera has been unplugged
E_ACCESSDENIED
Camera not found
E_FAIL
Failure
Remarks
If the Asynch property is set to TRUE, the Grab method will initiate the continuous acquisition and return after the first frame is acquired to the memory. Subsequent calls to the Grab method will return when the most recent frame is acquired to the memory.
If the Asynch property is set to FALSE, the method will initiate a single frame acquisition (One Shot mode) and return after the frame is acquired to the memory.
The FrameAcquired event will be raised after the Grab call is completed.
Note that the use of the Grab method is incompatible with the Acquire property set to TRUE. Make sure to set Acquire to FALSE when using Grab.
