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

Page: 220 / 357

220 PICam™ 5.x Programmer’s Manual Issue 11
7.4.1 Camera-Specific Advanced Discovery APIs
This section provides programming information for advanced camera-specific
discovery APIs.
7.4.1.1
PicamAdvanced_RegisterForDiscovery()
Description
PicamAdvanced_RegisterForDiscovery()
registers a function to call when camera
discovery is made.
NOTE:
Multiple functions may be registered. When this is the case,
the functions are called in the order in which they have
been registered.
Callback functions are called when any camera state that affects availability changes,
such as when:
• A camera is powered on and/or connected to the host computer;
• A connected camera is powered off or disconnected from the host computer;
• A camera is opened in another process;
• A camera is closed in another process.
Callback functions are also called when a camera has suffered a critical malfunction.
Callbacks are called asynchronously from another thread, but are serialized on that
thread. This means that additional notifications do not occur simultaneously, but occur
after each callback returns.
A camera may be unavailable for multiple reasons. Therefore, although callbacks may
repeatedly indicate a camera is lost each time one of the above states change, but the
camera is still not available.
Call
PicamAdvanced_UnregisterForDiscovery()
to unregister each callback once
it is no longer required.
Syntax
The syntax for
PicamAdvanced_RegisterForDiscovery()
is:
PICAM_API PicamAdvanced_RegisterForDiscovery(
PicamDiscoveryCallback discover)
Input Parameters
Input parameters for
PicamAdvanced_RegisterForDiscovery()
are:
Output Parameters
There are no output parameters associated with
PicamAdvanced_RegisterForDiscovery()
.
Related APIs
For additional information, refer to the following related APIs:
• PicamAdvanced_UnregisterForDiscovery()
discover:
The name assigned to the discovery callback function being registered.