TDS640__ScaleChannelData (ul_pbar_instruments)

 *  Synopsis:
 *    #include <ul_pbar_instruments:tds640.h>
 *
 *    int TDS640__ScaleChannelData( const CTDS640ptr tds640Ptr,
 *				    const ECHANnumber channel,
 *				    const char *rawData, float *scaledData )
 *
 *  Function intent:
 *    TDS640__ScaleChannelData() applies scaling and offset corrections to
 *    raw TDS 640 trace data to provide an output data array of engineering
 *    units.  The routine determines the number of points to convert from
 #    the data count in the header embedded within the raw data itself.
 *  Function parameters:
 *    CTDS640ptr	tds640Ptr	Valid TDS 640 module pointer
 *    ECHANnumber	channel		TDS 640 channel to be read:
 *					  kChan1 <= channel <= kChan4
 *    char		*rawData	Buffer containing raw waveform data
 *    float		*scaledData	Buffer large enough to contain dataCount
 *					scaled data values
 *  Function return value:
 *    CBS_OK		The data was successfully scaled
 *    CLIB_INVID	Invalid channel request
 *    CLIB_INVALID_DATA Invalid rawData was provided
 *    CLIB_NOINIT	A NULL data pointer was passed