dio_foreign_device_info_c

	status.i4.v = dio_foreign_device_info_c(device_indices.i4a.r,
						properties.i2a.r,
						num_entries.i4a.r,
						foreign_devices.sa.r,
						errors.i2a.r
						[,max_return.i4.v]
						[,num_devices.i4.v])

	This routine returns foreign device mapping information for a device
	or a list of devices.  The number of foreign device entries is
	returned in "num_entries".  If "max_entries" is specified, the number
	of entries per device returned will be limited to that number.
	"num_entries", however, will always contain the number of entries in
	the database for the corresponding device.  If "num_devices" is
	specified, foreign device mapping information for a list of devices
	can be retrieved.

	device_indices	device index or array of device indices
	properties	property index or array of indices
			(PRREAD -> reading property,
			 PRSET -> setting property,
			 PRBSTS -> basic status property,
			 PRBCTL -> basic control property)
			(If the first value is less than zero, all devices
			 will be requested with a property index which is
			 equal to the absolute value of this argument.)
			(constants are in 'dbprops')
	num_entries	returned number of foreign device mapping entries or
			array of number of foreign device mapping entries
			(A value of NULL may be passed if no entry counts
			 are needed.)
	foreign_devices	returned array of corresponding foreign device mapping
			entries (array of structures of type
			DIO_FOREIGN_DEVICE_ENTRY) (A value of NULL may be
			passed if no actual foreign device mapping
			entries are needed.)
	errors		returned ACNET status value or array of status values
	[max_return]	maximum number of foreign device mapping entries
			to return per device
			(default is DIO_MAX_FOREIGN_DEVICE_ENTRIES entries)
	[num_devices]	number of devices (default is 1)

	This function returns status values as follows:

	OK			success
	DIO_BADARG		invalid number of devices passed
	DIO_MEMFAIL		memory allocation failure
	negative value		ACNET format error indicating overall failure
	positive value		number of devices in error indicating partial
				success

	This function requires the following include files:

	cnsparam_h, diolib_h, acnet_errors_h

	Related functions:

	dio_longest_foreign_device_name_c, error_in_list(_c)

	C/C++ usage:

	short	properties = -PRREAD;
	short	errors[NUM_DEVICES];
	int	status;
	static const int	device_indices[NUM_DEVICES] = {225176, 225175};
	int	num_entries[NUM_DEVICES];
	int	max_return = MAX_ENTRIES;
	int	num_devices = NUM_DEVICES;
	DIO_FOREIGN_DEVICE_ENTRY	foreign_devices[NUM_DEVICES*MAX_ENTRIES];

	status = dio_foreign_device_info_c(device_indices,&properties,
					   num_entries,
					   foreign_devices,errors,
					   max_return,num_devices);