close_framegrabberT_close_framegrabberCloseFramegrabberCloseFramegrabberclose_framegrabber关闭帧抓取器(算子)
名称
close_framegrabberT_close_framegrabberCloseFramegrabberCloseFramegrabberclose_framegrabber — 关闭指定的图像采集设备。
签名
Herror T_close_framegrabber(const Htuple AcqHandle)
def close_framegrabber(acq_handle: HHandle) -> None
描述
算子 close_framegrabberclose_framegrabberCloseFramegrabberCloseFramegrabberCloseFramegrabberclose_framegrabber 关闭由 AcqHandleAcqHandleAcqHandleAcqHandleacqHandleacq_handle 指定的图像采集设备。具体而言,将释放为数据缓冲区分配的内存,并使该图像采集设备可供其他进程使用。
注意
对于多线程应用程序,info_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabberInfoFramegrabberinfo_framegrabber、open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber 和 close_framegrabberclose_framegrabberCloseFramegrabberCloseFramegrabberCloseFramegrabberclose_framegrabber 均为独占执行。因此,它们会阻塞彼此的并发执行,但与该组之外的所有非独占算子并行运行。
确保不会在另一个线程同时使用帧抓取器句柄的情况下调用 close_framegrabberclose_framegrabberCloseFramegrabberCloseFramegrabberCloseFramegrabberclose_framegrabber。
执行信息
- 多线程类型:可重入(与非独占算子并行运行)。
- 多线程作用域:全局(可从任何线程调用)。
- 未采用并行化处理。
此算子修改后续输入参数的状态:
在执行此算子时,若该参数值需在多个线程间使用,则必须对其访问进行同步。
参数
AcqHandleAcqHandleAcqHandleAcqHandleacqHandleacq_handle (输入控制,状态被修改) framegrabber → HFramegrabber, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
待关闭的图像采集设备句柄。
结果
如果指定的图像采集设备能够关闭,close_framegrabberclose_framegrabberCloseFramegrabberCloseFramegrabberCloseFramegrabberclose_framegrabber 返回值 2 (H_MSG_TRUE)。否则将抛出异常。
可能的前趋
grab_imagegrab_imageGrabImageGrabImageGrabImagegrab_image,
grab_image_asyncgrab_image_asyncGrabImageAsyncGrabImageAsyncGrabImageAsyncgrab_image_async
另见
open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber
模块
基础