USB 3.0 GigE	USB 3.0 GigE

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: You can query the temperature state of the camera. Temperature status monitoring is important for the camera's internal image memory (see Using the internal image memory).

•GigE uEye CP Rev. 2/GigE uEye FA/GigE uEye SE Rev. 4: You can query the temperature state of the camera.

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.

Fig. 214: Temperature state of USB 3 uEye CP Rev. 2

Fig. 215: Temperature state of GigE uEye CP Rev. 2/FA/SE Rev. 4

Input parameters

hCam	Camera handle
nCommand IS_DEVICE_FEATURE_CMD_GET_TEMPERATURE_STATUS Returns the last signaled temperature state.
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

Related functions

•Using the internal image memory

•is_EnableEvent()

•is_EnableMessage()

Example

// Is monitoring the temperature status supported?
INT nFeatures = 0;
is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_GET_SUPPORTED_FEATURES, &nFeatures, sizeof(nFeatures));
if ((nFeatures & IS_DEVICE_FEATURE_CAP_TEMPERATURE_STATUS) == IS_DEVICE_FEATURE_CAP_TEMPERATURE_STATUS)
{
 …
}

// Query the temperarture status
INT nTemperatureStatus = 0;
is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_GET_TEMPERATURE_STATUS, &nTemperatureStatus, sizeof(nTemperatureStatus));
if (nTemperatureStatus == TEMPERATURE_CONTROL_STATUS_CRITICAL)
{

 …

}
else if (nTemperatureStatus == TEMPERATURE_CONTROL_STATUS_WARNING)
{

 …

}
else if (nTemperatureStatus == TEMPERATURE_CONTROL_STATUS_NORMAL)
{

 …

}