Teledyne Princeton Instruments PICam 5.x, Руководство программиста

Страница: 242 / 357

242 PICam™ 5.x Programmer’s Manual Issue 11
7.4.8.5 PicamAdvanced_RegisterForPulseValueChanged()
Description
PicamAdvanced_RegisterForPulseValueChanged()
registers a function to call
when the value of a specified gate pulse parameter has been set, even if it is changed as
a result of a different parameter’s value being changed.
NOTE:
Multiple functions may be registered. When this is the case,
the functions are called in the order in which they have
been registered.
Registered callbacks are called synchronously from within the thread in which
associated parameter values are being set (i.e., called prior to returning from the set
operation.)
NOTE:
Parameters whose values have change due to external
influences (e.g., representing the status of camera
hardware,) do not result in a callback’s being called.
Call
PicamAdvanced_UnregisterForPulseValueChanged()
to unregister each
callback once it is not longer required.
Syntax
The syntax for
PicamAdvanced_RegisterForPulseValueChanged()
is:
PICAM_API PicamAdvanced_RegisterForPulseValueChanged(
PicamHandle camera,
PicamParameter parameter,
PicamPulseValueChangedCallback changed);
Input Parameters
Input parameters for
PicamAdvanced_RegisterForPulseValueChanged()
are:
Output Parameters
There are no output parameters associated with
PicamAdvanced_RegisterForPulseValueChanged() .
Related APIs
For additional information, refer to the following related APIs:
• Picam_SetParameterPulseValue() .
• PicamAdvanced_UnregisterForPulseValueChanged()
.
• PicamAdvanced_GetUserState() .
• PicamAdvanced_SetUserState() .
camera:
Handle for the camera for which the callback is being registered.
parameter:
The parameter for which the callback is being registered.
changed:
The name assigned to the callback function being registered.