dio_alarm_ftd_c

	status.i4.v = dio_alarm_ftd_c(device_index.i4.v, alarm_type.i4.v,
				      alarm_ftd.u2a.r, ftd.i2.v,
				      start_block.i4.v, max_blocks.i4.v,
				      num_blocks.i4.r)

	This routine returns the alarm FTD (scan rate) for a device.
	Not all front ends support this functionality.

	device_index	device index of interest
	alarm_type	type of alarm
			(DIO_ANALOG -> analog alarm,
			 DIO_DIGITAL -> digital alarm)
	alarm_ftd	returned alarm FTD (scan rate)
	ftd		frequency time descriptor
			(FTD_ONESHOT -> one shot,
			 FTD_DEFAULT -> use database default FTD,
			 FTD_1HZ -> 1 Hz request,
			 FTD_EVENT_MASK OR'ed with TCLK event value -> read
			 on TCLK event (event constants are in tclk_events)
			 (can use the macro BUILD_EVENT_FTD(event) or
			  BUILD_EVENT_PLUS_DELAY_FTD(event,delay) in 'macro'))
	start_block	starting block to return (starts at 0)
			(maximum is DIO_MAX_ALARM_BLOCKS - 1)
	max_blocks	maximum number of blocks to return per device
			(maximum is DIO_MAX_ALARM_BLOCKS)
	num_blocks	returned number of blocks returned
			(A value of NULL can be passed for this argument,
			 if this value is not needed.)

	This function returns ACNET status values as follows:

	OK			success
	otherwise		ACNET format error

	This function requires the following include files:

	diolib_h, acnet_errors_h, tclk_events_h, macro_h

	Related functions:

	dio_set_alarm_ftd_c, dio_alarm_tries_c, dio_alarm_tries_lst,
	dio_alarm_flags(_c), dio_alarm_limits(_c), dio_alarm_dnom(_c),
	dio_alarm_events(_c), dio_extract_alarm_info_c

	C/C++ usage:

	short	ftd = FTD_ONESHOT;
	unsigned short	alarm_ftd[NUM_BLOCKS];
	int	status;
	int	device_index = 14430;
	int	alarm_type = DIO_ANALOG;
	int	start_block = 0;
	int	max_blocks = NUM_BLOCKS;
	int	num_blocks;

	status = dio_alarm_ftd_c(device_index,alarm_type,alarm_ftd,
				 ftd,start_block,max_blocks,&num_blocks);