USB 3.0	USB 3.0

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:

•On the models UI-306x, UI-316x, and UI-318x: Enables the extended pixel clock range, see uEye Cockpit: 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.

Input parameters

hCam	Camera handle
nCommand IS_DEVICE_FEATURE_CMD_GET_EXTENDED_PIXELCLOCK_RANGE_ENABLE Returns the current setting for the extended pixel clock range. IS_DEVICE_FEATURE_CMD_SET_EXTENDED_PIXELCLOCK_RANGE_ENABLE Enables/disables the use of the extended pixel clock range: •1 = EXTENDED_PIXELCLOCK_RANGE_ON: Enables the extended pixel clock range. •0 = EXTENDED_PIXELCLOCK_RANGE_OFF: Disables the extended pixel clock range. IS_DEVICE_FEATURE_CMD_GET_EXTENDED_PIXELCLOCK_RANGE_ENABLE_DEFAULT Returns the default settings for the extended pixel clock range (default = EXTENDED_PIXELCLOCK_RANGE_OFF) (Example)
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

Example

UINT nEnable;
/* Get default value for the extended pixel clock range */
INT nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_GET_EXTENDED_PIXELCLOCK_RANGE_ENABLE_DEFAULT, (void*)&nEnable, sizeof(nEnable));
if (nRet == IS_SUCCESS)
{
/* Set default value */
nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_SET_EXTENDED_PIXELCLOCK_RANGE_ENABLE, (void*)&nEnable, sizeof(nEnable));
}
nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_GET_EXTENDED_PIXELCLOCK_RANGE_ENABLE, (void*)&nEnable, sizeof(nEnable));
if (nRet == IS_SUCCESS)
{
if (nEnable== EXTENDED_PIXELCLOCK_RANGE_ON)
{
  /* Extended pixel clock range is enabled */
}
}

/* Enable the extended pixel clock range */
nEnable = EXTENDED_PIXELCLOCK_RANGE_ON;
nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_SET_EXTENDED_PIXELCLOCK_RANGE_ENABLE, (void*)&nEnable, sizeof(nEnable));
if (nRet == IS_SUCCESS)
{
/* Extended pixel clock range is enabled */
}

/* Disable the extended pixel clock range */
nEnable = EXTENDED_PIXELCLOCK_RANGE_OFF;
nRet = is_DeviceFeature(hCam, IS_DEVICE_FEATURE_CMD_SET_EXTENDED_PIXELCLOCK_RANGE_ENABLE, (void*)&nEnable, sizeof(nEnable));
if (nRet == IS_SUCCESS)
{
/* Extended pixel clock range is disabled */
}