Teledyne Princeton Instruments PICam 5.x, Programmer'S Manual

Page: 250 / 357

250 PICam™ 5.x Programmer’s Manual Issue 11
7.4.9.5 PicamAdvanced_RegisterForFloatingPointValueChanged()
Description
PicamAdvanced_RegisterForFloatingPointValueChanged()
registers a function
to call when the floating point value for specified hardware 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 hardware,) do not
result in a callback’s being called.
Call
PicamAdvanced_UnregisterForFloatingPointValueChanged()
to
unregister each callback once it is not longer required.
Syntax
The syntax for
PicamAdvanced_RegisterForFloatingPointValueChanged()
is:
PICAM_API PicamAdvanced_RegisterForFloatingPointValueChanged(
PicamHandle camera_or_accessory,
PicamParameter parameter,
PicamFloatingPointValueChangedCallback changed);
Input Parameters
Input parameters for
PicamAdvanced_RegisterForFloatingPointValueChanged()
are:
Output Parameters
There are no output parameters associated with
PicamAdvanced_RegisterForFloatingPointValueChanged()
.
Related APIs
For additional information, refer to the following related APIs:
• Picam_SetParameterFloatingPointValue() .
• PicamAdvanced_UnregisterForFloatingPointValueChanged()
.
camera_or_accessory:
Handle for the hardware 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.