niHWS_ReadAnalogF64
C Function Prototype
tHWS_Status niHWS_ReadAnalogF64 (tHWS_WfmRef wfmReference, long numSamplesToRead, double* wfmBuffer, long* actualSamplesRead);
Purpose
Returns analog waveform samples as double-precision floating-point data beginning at the current read/write position.
Analog waveform data stored as doubles returns unaltered. Analog waveform data stored as integers (chars, shorts, or longs) is scaled to doubles using the stored scaling coefficients.
A read moves the read/write position so that it points to the next unread sample in the waveform.
Parameters
| Name | Type | Description |
|---|---|---|
| wfmReference | tHWS_WfmRef | A reference to the waveform. Waveforms are identified by reference for purposes of setting and getting waveform attributes and reading and writing data. |
| numSamplesToRead | long | Specifies how many samples to read into wfmBuffer.
If numSamplesToRead is 0, the number of samples in the waveform is returned in actualSamplesRead. |
| wfmBuffer | double* | The array that contains the data for the waveform. It is assumed that this array is big enough to contain at least the amount of data indicated by the value assigned to numSamplesToRead. |
| actualSamplesRead | long* | Reports the number of samples read.
If numSamplesToRead is 0, the number of samples in the waveform is returned in actualSamplesRead. |