Is_Configuration - THORLABS DCU223x Operation Manual And Sdk

4.3.11 is_Configuration

USB 2.0
USB 3.0
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
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
uc480 demo . This setting applies to all connected cameras. If no parameters are stored on the camera, the
80
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
hCam
nCommand
IS_CONFIG_CMD_GET_CAPABILITIES
IS_CONFIG_CPU_IDLE_STATES_CMD_GET_ENABL
E
© 2013 Thorlabs GmbH
USB 2.0
USB 3.0
is_ParameterSet()
Camera handle
Returns the configuration options supported by the
system.
pParam: Pointer to a UINT bitmask. The status flags
from
bitmask.
nSizeOfParam: 4
Example 1
Returns whether the current settings allow low power
consumption operating states (unequal C0).
pParam: Pointer to a UINT bitmask. The status flags
from
bitmask.
nSizeOfParam: 4
Example 2
Bayer conversion
function or via the corresponding
292
Additional information
CONFIGURATION_CAPS
186
Additional information
CONFIGURATION_SEL
186
4 Programming (SDK)
, are distributed
26
function in the
are returned in the
185
are returned in the
185
183