Home > C: Programming > Function Descriptions > History back  Previous chapter  Next chapter  Print  

is_SetPersistentIpCfg

uEye Camera Manual Version 3.80

is_SetPersistentIpCfg

Windows_Logo

Linux_Logo

GigE

GigE

Syntax

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

Description

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 uEye 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

pIpCfg is invalid.

IS_BAD_STRUCTURE_SIZE

The structure size you specified is invalid.

IS_NOT_SUPPORTED

For hDev, no device ID was specified or the ID is no device ID for an Ethernet camera (see above).

IS_CANT_OPEN_DEVICE

Driver could not be found.

IS_IO_REQUEST_FAILED

Driver communication failed.

Related Functions

is_SetAutoCfgIpSetup()
is_GetEthDeviceInfo()

Code Sample

//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!


© 2010 IDS Imaging Development Systems GmbH
http://www.ids-imaging.com