Interface for being notified when a driver property is changed.
More...
Interface for being notified when a driver property is changed.
◆ CVBDRIVER_PROPERTYCHANGE_CB
- Attention
- The list below descripes the specific constant declarations and typedefs. There are declared in the header file iCVCDriver.h.
- Parameters
-
[in] | ReasonForCall | |
[out] | Answer | |
[in] | pPrivate | Pointer to private data (e.g. class pointer) which is passed to the callback functions. |
[in] | Reserved1 | |
[in] | Reserved2 | |
- Returns
TRUE
if succeeded, otherwise FALSE
.
- Supported platforms:
- Win32
Win64
Linux
◆ IMAGEPROPCHANGE_ANSWER
IMAGEPROPCHANGE_ANSWER enumerated values can be used in your implementation of a CVBDRIVER_PROPERTYCHANGE_CB callback to signal to the calling driver how to proceed with a requested property change.
- Attention
- The list below describes the specific constant declarations and typedefs. These are declared in the header file iCVCDriver.*.
Enumerator |
---|
IMAGEPROPCHANGE_ANSWER_OK | Return this value in the CVBDRIVER_PROPERTYCHANGE_CB call to let the calling driver know that a property change is acceptable.
|
IMAGEPROPCHANGE_ANSWER_CANCEL | Return this value in the CVBDRIVER_PROPERTYCHANGE_CB call to let the calling driver know that a property change is to be canceled.
|
◆ IMAGEPROPCHANGE_REASON
IMAGEPROPCHANGE_REASON is used in the IPropertyChange interface for communicating the context of the invocation of the CVBDRIVER_PROPERTYCHANGE_CB callback.
- Attention
- The list below describes the specific constant declarations and typedefs. These are declared in the header file iCVCDriver.* .
Enumerator |
---|
IMAGEPROPCHANGE_REASON_BFORE_IMAGE_CHANGE | callback is invoked before an image property is about to change
|
IMAGEPROPCHANGE_REASON_AFTER_IMAGE_CHANGE | callback is invoked after an image property has changed
|
IMAGEPROPCHANGE_REASON_NEW_IMAGESIZE | callback is invoked after the size of an image has changed
|
IMAGEPROPCHANGE_REASON_TIMEOUT | callback is invoker after an acquisition timed out
|
◆ CanPropertyChange()
cvbbool_t CanPropertyChange |
( |
IMG |
Image | ) |
|
This function verifies whether the image supports the PropertyChange interface.
- Parameters
-
[in] | Image | Handle of image object. |
- Returns
TRUE
if the image supports the PropertyChange interface, FALSE
otherwise.
- Supported platforms:
- Win32
Win64
Linux
- Examples:
- Visual C++ - VC MDI Example (DLL only)
◆ PCRegisterCallBack()
Registers a callback function that is called by the driver on changes of properties.
A registered callback function must be unregistered using the PCUnRegisterCallBack function.
- Parameters
-
[in] | Image | Handle of image object. |
[in] | pDriverCB | Pointer to the callback function of the type CVBDRIVER_PROPERTYCHANGE_CB. |
[in] | pPrivate | Pointer to private data (e.g. class pointer) which is passed to the callback functions. |
- Returns
- >=0 : OK
<0 : an error occured
- Supported platforms:
- Win32
Win64
Linux
- Examples:
- Visual C++ - VC MDI Example (DLL only)
◆ PCUnRegisterCallBack()
Unregisters a previously registered callback function.
- Parameters
-
- Returns
- >=0 : OK
<0 : an error occured
- Supported platforms:
- Win32
Win64
Linux
- Examples:
- Visual C++ - VC MDI Example (DLL only)