© 2016 Thorlabs Scientific Imaging148
DCx Camera Functional Description and SDK Manual
4.3.11 is_Configuration
Syntax
INT is_Configuration (UINT nCommand, void* pParam, UINT cbSizeOfParam)
Description
Use is_Configuration() to set various system-wide options:
Windows only: Processor operating states (idle states/C-states)
Modern processors have various operating states, so-called C-states, that are characterized by
different power requirements. When the operating system selects an operating state with low
power consumption (unequal C0), the USB transmission efficiency may be affected.
Use the function parameters IS_CONFIG_CPU_IDLE_STATES_CMD… to disable these low power
consumption operating states and improve USB transmission efficiency. The uc480 driver
changes the current energy settings of the operating system when the first USB DCx camera is
opened. After the last USB DCx camera is closed, the uc480 driver restores the original settings.
The settings are valid for the current user only.
Windows only: Activate OpenMP (Open Multi-Processing)
OpenMP is a programming interface that supports distributed computing on multi-core
processors. When you activate OpenMP support, intensive computing operations, such as the
Bayer conversion, are distributed across several processor cores to accelerate execution. The
use of OpenMP, however, increases CPU load.
Load camera parameters during installation
Use the function parameters IS_CONFIG_INITIAL_PARAMETERSET… to indicate whether to apply the
parameters stored on the camera automatically when opening the camera. You must first store
the camera parameters on the camera using the is_ParameterSet() function or via the
corresponding function in the uc480 demo. This setting applies to all connected cameras. If no
parameters are stored on the camera, the standard parameters of this camera model are
applied.
The nCommand input parameter is used to select the function mode. The pParam input parameter
depends on the selected function mode. If you select functions for setting or returning a value,
pParam contains a pointer to a variable of the UINT type. The size of the memory area to which
pParam refers is specified in the cbSizeOfParam input parameter.
Note
Settings for processor operating states: The settings for processor operating states are available only
on Windows operating systems.
Input parameters
IS_CONFIG_CMD_GET_CAPABILITIES
Returns the configuration options supported by
the system.
Additional information
pParam: Pointer to a UINT bitmask. The status
flags from CONFIGURATION_CAPS are returned in
the bitmask.
To Next Page
Loading...
Need help?
General
