USB 2.0 USB 3.x GigE |
USB 2.0 USB 3.x GigE |
Syntax
INT is_Configuration (UINT nCommand, void* pParam, UINT cbSizeOfParam)
Description
Use is_Configuration() to set various system-wide options:
Processor operating states under Windows
IP address of the network adapter
Image memory compatibility mode
Loading camera parameters during initializing
Trusted pairing mode for GigE uEye cameras
Configuration mode under Linux
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.
Input parameters
hCam |
Camera handle |
pParam |
Pointer to a function parameter, whose function depends on nCommand. |
cbSizeOfParam |
Size (in bytes) of the memory area to which pParam refers. |
Contents of the CONFIGURATION_CAPS structure
INT |
IS_CONFIG_CPU_IDLE_STATES_CAP_SUPPORTED |
Function parameters for setting the processor operating states are supported. |
INT |
IS_CONFIG_OPEN_MP_CAP_SUPPORTED |
Function parameters to configure OpenMP are supported. |
INT |
IS_CONFIG_INITIAL_PARAMETERSET_CAP_SUPPORTED |
Function parameters to load camera parameters during initialization are supported. |
INT |
IS_CONFIG_IPO_CAP_SUPPORTED |
Function parameters for setting the IPO thread are supported. |
INT |
IS_CONFIG_TRUSTED_PAIRING_CAP_SUPPORTED |
Function parameters for setting the trusted pairing mode are supported. |
Contents of the CONFIGURATION_SEL structure
INT |
IS_CONFIG_CPU_IDLE_STATES_BIT_AC_VALUE |
Set/recover processor operating states for power supply unit operation |
INT |
IS_CONFIG_CPU_IDLE_STATES_BIT_DC_VALUE |
Set/recover processor operating states for battery operation |
INT |
IS_CONFIG_IPO_NOT_ALLOWED |
IPO thread not allowed |
INT |
IS_CONFIG_IPO_ALLOWED |
IPO thread allowed |
INT |
IS_CONFIG_OPEN_MP_DISABLE |
OpenMP support disabled |
INT |
IS_CONFIG_OPEN_MP_ENABLE |
OpenMP support enabled |
INT |
IS_CONFIG_INITIAL_PARAMETERSET_NONE |
Load camera parameters during initialization disabled |
INT |
IS_CONFIG_INITIAL_PARAMETERSET_1 |
Load camera parameter set 1 during initialization |
INT |
IS_CONFIG_ETH_CONFIGURATION_MODE_ON |
Linux only: Enables the configuration mode for the ETH daemon. |
INT |
IS_CONFIG_ETH_CONFIGURATION_MODE_OFF |
Linux only: Disables the configuration mode for the ETH daemon. |
INT |
IS_CONFIG_TRUSTED_PAIRING_ON |
Enables the trusted pairing mode. |
INT |
IS_CONFIG_TRUSTED_PAIRING_OFF |
Disables the trusted paring mode. |
INT |
IS_CONFIG_IMAGE_MEMORY_COMPATIBILITY_MODE_OFF |
Disables image memory compatibility mode |
INT |
IS_CONFIG_IMAGE_MEMORY_COMPATIBILITY_MODE_ON |
Enables image memory compatibility mode |
Return values
IS_CANT_OPEN_REGISTRY |
Error opening a Windows registry key |
IS_CANT_READ_REGISTRY |
Error reading settings from the Windows registry |
IS_ERROR_CPU_IDLE_STATES_CONFIGURATION |
The configuration of the CPU idle has failed. |
IS_INVALID_PARAMETER |
One of the submitted parameters is outside the valid range or is not supported for this sensor or is not available in this mode. |
IS_NO_IMAGE_MEM_ALLOCATED |
The driver could not allocate memory. |
IS_NO_SUCCESS |
General error message |
IS_NOT_SUPPORTED |
The camera model used here does not support this function or setting. |
IS_OPERATING_SYSTEM_NOT_SUPPORTED |
Operating system not supported |
IS_SUCCESS |
Function executed successfully |
UINT nCaps = 0;
INT nRet = is_Configuration(IS_CONFIG_CMD_GET_CAPABILITIES, (void*)&nCaps, sizeof(UINT));
if (nRet == IS_SUCCESS)
{
if (nCaps & IS_CONFIG_CPU_IDLE_STATES_CAP_SUPPORTED)
{
// CPU idle states supported
}
if (nCaps & IS_CONFIG_OPEN_MP_CAP_SUPPORTED)
{
// OpenMP supported
}
if (nCaps & IS_CONFIG_INITIAL_PARAMETERSET_CAP_SUPPORTED)
{
// Initial parameter set supported
}
}