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

Page: 258 / 357

258 PICam™ 5.x Programmer’s Manual Issue 11
7.4.10.3 PicamAdvanced_RegisterForValueAccessChanged()
Description
PicamAdvanced_RegisterForValueAccessChanged()
registers a function to call
when the value access for a parameter has been changed, 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.)
Call
PicamAdvanced_UnregisterForValueAccessChanged()
to unregister each
callback once it is not longer required.
Syntax
The syntax for
PicamAdvanced_RegisterForValueAccessChanged()
is:
PICAM_API PicamAdvanced_RegisterForValueAccessChanged(
PicamHandle camera_or_accessory,
PicamParameter parameter,
PicamValueAccessChangedCallback changed);
Input Parameters
Input parameters for
PicamAdvanced_RegisterForValueAccessChanged()
are:
Output Parameters
There are no output parameters associated with
PicamAdvanced_RegisterForValueAccessChanged()
.
Related APIs
For additional information, refer to the following related APIs:
• PicamAdvanced_UnregisterForValueAccessChanged() .
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.