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

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

256 PICam™ 5.x Programmer’s Manual Issue 11
7.4.10 Shared Camera/Accessory Advanced Parameter Information APIs
This section provides programming information for camera and accessory advanced
parameter information APIs.
7.4.10.1
PicamAdvanced_RegisterForIsRelevantChanged()
Description
PicamAdvanced_RegisterForIsRelevantChanged()
registers a function to call
when the relevance 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_UnregisterForIsRelevantChanged()
to unregister each
callback once it is not longer required.
Syntax
The syntax for
PicamAdvanced_RegisterForIsRelevantChanged()
is:
PICAM_API PicamAdvanced_RegisterForIsRelevantChanged(
PicamHandle camera_or_accessory,
PicamParameter parameter,
PicamIsRelevantChangedCallback changed);
Input Parameters
Input parameters for
PicamAdvanced_RegisterForIsRelevantChanged()
are:
Output Parameters
There are no output parameters associated with
PicamAdvanced_RegisterForIsRelevantChanged()
.
Related APIs
For additional information, refer to the following related APIs:
• PicamAdvanced_UnregisterForIsRelevantChanged()
.
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.