名称
get_framegrabber_callback - 查询图像采集设备的回调函数。
用法
get_framegrabber_callback( : : AcqHandle, CallbackType : CallbackFunction, UserContext)
描述
算子get_framegrabber_callback查询由AcqHandle指定的图像采集设备的回调函数。 如果之前通过set_framegrabber_callback注册了回调函数，则CallbackFunction包含一个指向它的指针，否则为NULL。 此外，UserContext包含一个指向通过set_framegrabber_callback（或NULL）设置的用户特定上下文数据的指针。
使用参数CallbackType，您可以选择不同的回调类型。 建议值为：
'exception':
图像采集引发了一个异常。
'exposure_end':
下一张照片的曝光已经完成。
'exposure_start':
下一张照片的曝光已经开始。
'transfer_end':
一个新的图像准备好由grab_image_async获取。
根据底层API的功能，CallbackType的附加值是可能的。 通过调用带有参数'available_callback_types'的get_framegrabber_param，可以查询特定图像采集设备实际支持的所有回调类型。 有关更多详细信息，请参阅特定图像采集界面的文档。
注意
对于多线程应用程序，所有图像采集算子（如open_framegrabber中列出的）都是自己的组，其中info_framegrabber，open_framegrabber，close_framegrabber和close_all_framegrabbers是独占执行的。
get_framegrabber_callback与该组内部和外部的所有非独占运算符并行运行。
并行
● 多线程类型：可重入（与非独占算子并行运行）。
● 多线程范围：全局（可以从任何线程调用）。
● 不并行化处理。
参数
AcqHandle (input_control) framegrabber → (integer)
要使用的采集设备的句柄。
CallbackType (input_control) string → (string)
回调类型。
Default value: 'transfer_end'
Suggested values: 'exception', 'exposure_end', 'exposure_start', 'transfer_end'
CallbackFunction (output_control) pointer → (integer)
指向回调函数的指针。
UserContext (output_control) pointer → (integer)
指向用户特定上下文数据的指针。
结果
如果图像采集设备已打开并且支持指定的回调类型，则算子get_framegrabber_callback将返回值2（H_MSG_TRUE）。 否则会引发异常。
Possible Predecessors
open_framegrabber, set_framegrabber_callback
Possible Successors
grab_image, grab_data, grab_image_start, grab_image_async, grab_data_async, set_framegrabber_param, close_framegrabber
See also
open_framegrabber, info_framegrabber, set_framegrabber_callback
模块
Foundation