close_framegrabberT_close_framegrabberCloseFramegrabberCloseFramegrabberclose_framegrabber (Operator)
Name
close_framegrabberT_close_framegrabberCloseFramegrabberCloseFramegrabberclose_framegrabber — Close specified image acquisition device.
Signature
Herror T_close_framegrabber(const Htuple AcqHandle)
def close_framegrabber(acq_handle: HHandle) -> None
Description
The operator close_framegrabberclose_framegrabberCloseFramegrabberCloseFramegrabberCloseFramegrabberclose_framegrabber closes the image acquisition device
specified by AcqHandleAcqHandleAcqHandleAcqHandleacqHandleacq_handle. In particular, allocated memory for data
buffers is released and the image acquisition device is made available for
other processes.
Attention
For a multithreaded application,
info_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabberInfoFramegrabberinfo_framegrabber, open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber, and
close_framegrabberclose_framegrabberCloseFramegrabberCloseFramegrabberCloseFramegrabberclose_framegrabber are executed exclusively. Thus,
they block the concurrent execution of each other, but run in
parallel with all non-exclusive operators outside of this group.
Make sure that close_framegrabberclose_framegrabberCloseFramegrabberCloseFramegrabberCloseFramegrabberclose_framegrabber is not called for a framegrabber
handle that is being used by another thread concurrently.
Execution Information
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
This operator modifies the state of the following input parameter:
During execution of this operator, access to the value of this parameter must be synchronized if it is used across multiple threads.
Parameters
AcqHandleAcqHandleAcqHandleAcqHandleacqHandleacq_handle (input_control, state is modified) framegrabber → HFramegrabber, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of the image acquisition device to be closed.
Result
If the specified image acquisition device could be closed,
close_framegrabberclose_framegrabberCloseFramegrabberCloseFramegrabberCloseFramegrabberclose_framegrabber returns the value 2 (H_MSG_TRUE).
Otherwise an exception is raised.
Possible Predecessors
grab_imagegrab_imageGrabImageGrabImageGrabImagegrab_image,
grab_image_asyncgrab_image_asyncGrabImageAsyncGrabImageAsyncGrabImageAsyncgrab_image_async
See also
open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber
Module
Foundation