Name
close_framegrabberclose_framegrabberCloseFramegrabberclose_framegrabberCloseFramegrabberCloseFramegrabber — Close specified image acquisition device.
Herror close_framegrabber(const Hlong AcqHandle)
Herror T_close_framegrabber(const Htuple AcqHandle)
Herror close_framegrabber(const HTuple& AcqHandle)
void CloseFramegrabber(const HTuple& AcqHandle)
The operator close_framegrabberclose_framegrabberCloseFramegrabberclose_framegrabberCloseFramegrabberCloseFramegrabber closes the image acquisition device
specified by AcqHandleAcqHandleAcqHandleAcqHandleAcqHandleacqHandle. In particular, allocated memory for data
buffers is released and the image acquisition device is made available for
other processes.
Basically an image acquisition handle AcqHandleAcqHandleAcqHandleAcqHandleAcqHandleacqHandle cannot be used
in multiple threads. However, possible exceptions are described in the
specific reference documentation of the respective image acquisition interface.
Different image acquisition handles can be used safely with different threads
for each handle.
For a multithreaded application all image acquisition operators
(as listed in open_framegrabberopen_framegrabberOpenFramegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber) are
an own group in which info_framegrabberinfo_framegrabberInfoFramegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabber, open_framegrabberopen_framegrabberOpenFramegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber,
close_framegrabberclose_framegrabberCloseFramegrabberclose_framegrabberCloseFramegrabberCloseFramegrabber and close_all_framegrabbersclose_all_framegrabbersCloseAllFramegrabbersclose_all_framegrabbersCloseAllFramegrabbersCloseAllFramegrabbers are
executed exclusively.
Thus, info_framegrabberinfo_framegrabberInfoFramegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabber, open_framegrabberopen_framegrabberOpenFramegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber,
close_framegrabberclose_framegrabberCloseFramegrabberclose_framegrabberCloseFramegrabberCloseFramegrabber and close_all_framegrabbersclose_all_framegrabbersCloseAllFramegrabbersclose_all_framegrabbersCloseAllFramegrabbersCloseAllFramegrabbers block the
concurrent execution of all other operators within this group, but run in
parallel with all non-exclusive operators outside of this group.
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Handle of the image acquisition device to be closed.
If the specified image acquisition device could be closed,
close_framegrabberclose_framegrabberCloseFramegrabberclose_framegrabberCloseFramegrabberCloseFramegrabber returns the value 2 (H_MSG_TRUE).
Otherwise an exception is raised.
grab_imagegrab_imageGrabImagegrab_imageGrabImageGrabImage,
grab_image_asyncgrab_image_asyncGrabImageAsyncgrab_image_asyncGrabImageAsyncGrabImageAsync
open_framegrabberopen_framegrabberOpenFramegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber
Foundation