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.
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
// 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 ));