DIO__InitializeDeviceList (ul_pbar_dio)

 *  Synopsis:
 *    #include <ul_pbar_dio:dio.h>
 *
 *    CDIOLptr DIO__InitializeDeviceList( int *errorCode, const int retryCount,
 *					  const int deviceCount,
 *					  const char *deviceNames[],
 *					  const int getFlag, const int setFlag,
 *					  short int ftd)
 *
 *  Function intent:
 *    DIO__InitializeDevice() requests the DIs for the specified list of ACNET
 *    devices.  If successful it returns a unique DIO device list I/O control
 *    pointer for use in future DIO__xxxList() calls.
 *  Function parameters:
 *    int	*errorCode	DIO I/O status/error code - returned
 *    int	retryCount	# of retry attempts to use on DIO__xxxList calls
 *    int	deviceCount	# of devices in the list
 *    char	*deviceNames[]	pointer to array of device name string pointers
 *    int	getFlag		enable list reads
 *    int	setFlag		enable list sets
 *    short int	ftd		Frequency/Time Descriptor
 *  errorCode return values:
 *    DIO_OK		success
 *    CLIB_MEMFAIL	memory allocation failed
 *    DIO_BADARG	invalid ACNET device name
 *    DIO_MEMFAIL	memory allocation failure in dio routine
 *    negative value	ACNET format error indicating overall failure
 *  Function return value:
 *    NULL		ACNET I/O error or memory alloc error - see errorCode
 *    otherwise		unique DIO device I/O control pointer