TDS640__ReadChannel (ul_pbar_instruments)

 *  Synopsis:
 *    #include <ul_pbar_instruments:tds640.h>
 *
 *    int TDS640__ReadChannel( const CTDS640ptr tds640Ptr,
 *			       const ECHANnumber channel, char *buffer,
 *			       const int numPoints )
 *
 *  Function intent:
 *    TDS640__ReadChannel() reads a single TDS 640 channel waveform and related
 *    scaling parameters.
 *  Function parameters:
 *    CTDS640ptr	tds640Ptr	Valid TDS 640 module pointer
 *    ECHANnumber	channel		TDS 640 channel to be read:
 *					  kChan1 <= channel <= kChan4
 *    char		*buffer		Buffer large enough for numPoints bytes
 *					plus 5 or 6 bytes of waveform header
 *					of the format:
 *					  #xyyyy where x is the number of digits
 *					  to follow and yyyy is the number of
 *					  bytes of binary waveform data to
 *					  follow.  Example #3500 for 500 bytes
 *					  of waveform data.
 *    int		numPoints	Number of data points expected:
 *					  1 <= numPoints <= KMAXDATAPOINTCOUNT
 *  Function return value:
 *    CBS_OK		Initialization was successful
 *    CLIB_INVID	Invalid channel request
 *    CLIB_INVSIZ	TDS 640 was setup for more data than numPoints request
 *    CLIB_GENERR	Unable to write TDS 640 command(s) 
 *    CLIB_INVALID_DATA	TDS 640 status error after GPIB command