 |
 |
|---|---|
GigE |
GigE |
Syntax
INT is_SetPersistentIpCfg (HIDS hDev, UEYE_ETH_IP_CONFIGURATION* pIpCfg, UINT uStructSize)
Description
|
This function is obsolete and should not be used anymore. We recommend to use the is_IpConfig() function instead. |
Using is_SetPersistentIpCfg(), you can set the properties of the persistent IP configuration for a connected camera. The IP configuration can also be changed using the IDS Camera Manager.
|
The is_SetPersistentIpCfg() function is only supported by cameras of the GigE uEye series. |
Input parameters
hDev |
DevID | IS_USE_DEVICE_ID |
pIpCfg |
Pointer to a UEYE_ETH_IP_CONFIGURATION object (see below). |
uStructSize |
Size of the UEYE_ETH_IP_CONFIGURATION structure (in bytes). |
|
The is_SetPersistentIpCfg() function does not accept a camera handle in the hDev parameter. In the call, please use the internal device ID as described below. Never modify the IP configuration after a GigE uEye camera has been initialized! |
Contents of the UEYE_ETH_IP_CONFIGURATION structure
UEYE_ETH_ADDR_IPV4 |
ipAddress |
IPv4 address When 0x00000000 (IP address 0.0.0.0) is passed: |
UEYE_ETH_ADDR_IPV4 |
ipSubnetmask |
IPv4 subnet mask |
BYTE |
reserved[4] |
reserved |
Return values
IS_SUCCESS |
Function executed successfully |
IS_INVALID_PARAMETER |
One of the submitted parameters is outside the valid range or is not supported for this sensor or is not available in this mode. |
IS_BAD_STRUCTURE_SIZE |
An internal structure has an incorrect size. |
IS_NOT_SUPPORTED |
The camera model used here does not support this function or setting. |
IS_CANT_OPEN_DEVICE |
An attempt to initialize or select the camera failed (no camera connected or initialization error). |
IS_IO_REQUEST_FAILED |
An IO request from the uEye driver failed. Possibly the versions of the ueye_api.dll (API) and the driver file (ueye_usb.sys or ueye_eth.sys) do not match. |
Related functions
•is_IpConfig()
•is_DeviceInfo()
Example
//Create the structure
UEYE_ETH_IP_CONFIGURATION ipcfg;
//Create specific camera handle from the internal device ID, see info in the box above
HIDS hDev = (HIDS)( dwDeviceID | IS_USE_DEVICE_ID);
//Indicate addresses in hexadecimal format
ipcfg.ipAddress.dwAddr = 0xC0A80A02; //IP address 192.168.10.2
ipcfg.ipSubnetmask.dwAddr = 0xFFFFFF00; //Subnet mask 255.255.255.0
//Set persistent IP address
INT nRet = is_SetPersistentIpCfg( hDev, &ipcfg, sizeof(UEYE_ETH_IP_CONFIGURATION));
