niHWS_ReadDigitalU8
C Function Prototype
tHWS_Status niHWS_ReadDigitalU8 (tHWS_WfmRef wfmReference, long numSamplesToRead, unsigned char* wfmBuffer, long* actualSamplesRead);
Purpose
Returns digital waveform samples as 8-bit unsigned integers (U8) beginning at the current read/write position.
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 | unsigned 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. |