Please enable JavaScript to view this site.

IDS Software Suite 4.96.1

Windows_Logo
Linux_Logo

USB 2.0

USB 3.x

GigE

-

Syntax

INT is_Configuration (UINT nCommand, void* pParam, UINT cbSizeOfParam)

Description

The IPO thread (thread for performance optimization at image acquisition) is thread that runs with lowest priority. The IPO thread prevents the PC to use the power saving mode. If you already changed the power scheme of the operating system via the idle states, you must not use the IPO thread.

If the IPO thread is allowed, the uEye API optimizes the performance if a USB uEye camera is connected, more than one active CPU core is detected and the CPU supports C-states.

Note that you need administrator privileges to configure the IPO thread.

hint_info

Note: The IPO thread seems to increase the CPU load and prevents the PC to use the power saving mode. However, the IPO thread runs with lowest priority. If another thread needs the CPU, it gets the CPU immediately.

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_IPO_CAP_SUPPORTED

Function parameters for setting the IPO thread are supported.

Contents of the CONFIGURATION_SEL structure

INT

IS_CONFIG_IPO_NOT_ALLOWED

IPO thread not allowed

INT

IS_CONFIG_IPO_ALLOWED

IPO thread allowed

See also

Processor operating states under Windows

Example

// Do not allow IPO thread
UINT nAllowIpo = IS_CONFIG_IPO_NOT_ALLOWED;
INT nRet = is_Configuration(IS_CONFIG_IPO_CMD_SET_ALLOWED, (void*)&nAllowIpo , sizeof(nAllowIpo));
 
// Read value
nRet = is_Configuration(IS_CONFIG_IPO_CMD_GET_ALLOWED, (void*)&nAllowIpo , sizeof(nAllowIpo ));

© 2022 IDS Imaging Development Systems GmbH