is_SetPersistentIpCfg


GigE	GigE

Syntax

INT is_SetPersistentIpCfg (HIDS hDev,
UEYE_ETH_IP_CONFIGURATION* pIpCfg,
UINT uStructSize)

Description

Achtung

This function is obsolete and should not be used anymore. We recommend to use the is_IpConfig() function instead (see also Obsolete functions).

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.

Hinweis

The is_SetPersistentIpCfg() function is only supported by cameras of the GigE uEye series.

Input parameters

hDev	DevID \| IS_USE_DEVICE_ID DevID = internal device ID of the camera from the UEYE_CAMERA_INFO structure (see also is_GetCameraList()).
pIpCfg	Pointer to a UEYE_ETH_IP_CONFIGURATION object (see below).
uStructSize	Size of the UEYE_ETH_IP_CONFIGURATION structure (in bytes).

Achtung

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:
A valid IP address from the address range specified will be automatically assigned when the camera is opened (see is_SetAutoCfgIpSetup()).

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

Suggestion for improvement? Send us your short Feedback on this chapter. Thank you very much!

For technical questions please contact you local distributor or use the support form on our website.

Home > C: Programming > Obsolete functions >	History back Previous chapter Next chapter Print
is_SetPersistentIpCfg