USB 3 uEye CP Rev. 2 |
USB 3 uEye CP Rev. 2 |
Syntax
INT is_DeviceFeature (HIDS hCam, UINT nCommand, void* pParam, UINT cbSizeOfParam)
Description
Using is_DeviceFeature() you can configure special camera functions provided by specific uEye models:
•USB 3 uEye CP Rev. 2: Enable or disable the image memory of the camera.
From IDS Software Suite 4.81 on, the camera is operated with active image memory by default. Deactivation of the image memory is not possible any more. See IDS Camera Manager: Camera information. If you check the "Compatibility mode" option, you can disable the internal image memory again. This corresponds to the camera behavior up to and including IDS Software Suite 4.80.2. |
•Note that the camera has to be closed if you enable or disable the image memory.
•For some USB 3 uEye cameras, you must activate the image memory to operate them on a USB 2.0 port, see Camera and sensor data.
•If the image memory is activated the cameras can be operated with a higher pixel clock and frame rate. Temporary CPU loads are therefore compensated.
•Note that higher camera pixel clocks causes a higher power consumption. Therefore, provide sufficient heat dissipation, see Ambient conditions USB 3 uEye CP Rev. 2.
Hint: Note that from driver version 4.80 on the internal image memory can only be enabled or disabled when the device ID and not the camera handle is used for calling. Please refer to the Application Note on our website for more information on this topic. |
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. |
Status flags from DEVICE_FEATURE_MODE_CAPS
IS_DEVICE_FEATURE_CAP_MEMORY_MODE |
Internal image memory is supported. |
Related functions
•Querying the temperature state
// Is using the image memory supported?
// Via camera handle
int nMemoryMode;
nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_GET_MEMORY_MODE_ENABLE_SUPPORTED, &nMemoryMode, sizeof(nMemoryMode));
if (nMemoryMode == IS_MEMORY_MODE_ON)
{
// is supported...
}
// Is using the image memory supported?
// Via device ID
int nMemoryMode;
nRet = is_DeviceFeature(nDevID | IS_USE_DEVICE_ID, IS_DEVICE_FEATURE_CMD_GET_MEMORY_MODE_ENABLE_SUPPORTED, &nMemoryMode, sizeof(nMemoryMode));
if (nMemoryMode == IS_MEMORY_MODE_ON)
{
// is supported...
}
// Enable memory mode, device ID must be used for this purpose
UINT nEnable = IS_MEMORY_MODE_ON;
INT nRet = is_DeviceFeature(nDevID | IS_USE_DEVICE_ID, IS_DEVICE_FEATURE_CMD_SET_MEMORY_MODE_ENABLE, (void*)&nEnable, sizeof(nEnable));
// Query the status of the image memory via camera handle
int nMemoryMode;
nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_GET_MEMORY_MODE_ENABLE, &nMemoryMode, sizeof(nMemoryMode));
if (nMemoryMode == IS_MEMORY_MODE_ON)
{
…
}
// Query the status of the image memory via device ID
int nMemoryMode;
nRet = is_DeviceFeature(nDevID | IS_USE_DEVICE_ID, IS_DEVICE_FEATURE_CMD_GET_MEMORY_MODE_ENABLE, &nMemoryMode, sizeof(nMemoryMode));
if (nMemoryMode == IS_MEMORY_MODE_ON)
{
…
}
// Query the default setting for the image memory via camera handle
int nMemoryMode;
nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_GET_MEMORY_MODE_ENABLE_DEFAULT, &nMemoryMode, sizeof(nMemoryMode));
if (nMemoryMode == IS_MEMORY_MODE_ON)
{
…
}
// Query the default setting for the image memory via device ID
int nMemoryMode;
nRet = is_DeviceFeature(nDevID | IS_USE_DEVICE_ID, IS_DEVICE_FEATURE_CMD_GET_MEMORY_MODE_ENABLE_DEFAULT, &nMemoryMode, sizeof(nMemoryMode));
if (nMemoryMode == IS_MEMORY_MODE_ON)
{
…
}