niHWS_ReadAnalogI8
C Function Prototype
tHWS_Status niHWS_ReadAnalogI8 (tHWS_WfmRef wfmReference, long numSamplesToRead, char* wfmBuffer, long* actualSamplesRead);
Purpose
Returns analog waveform samples as 8-bit signed integers (I8) beginning at the current read/write position. Only I8 data can be retrieved with this function.
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 | char* | 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. |