Please enable JavaScript to view this site.

IDS Software Suite 4.96.1

Windows_Logo
Linux_Logo

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

Allowing IPO thread

Image memory compatibility mode

Activating OpenMP

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

Example

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
  }
}

© 2022 IDS Imaging Development Systems GmbH