niHSDIO_FetchMultiRecordU8
Specific Function
C Function Prototype
ViStatus niHSDIO_FetchMultiRecordU8 (ViSession vi, ViInt32 samplesToRead, ViInt32 maxTimeMilliseconds, ViInt32 startingRecord, ViInt32 recordsToRead, ViUInt8[] waveformData, niHSDIO_wfmInfo * waveformInfo);
Purpose
Fetches the data as a two-dimensional array of unsigned 8-bit integers and returns the number of samples read.
Parameters
| Name | Type | Description |
|---|---|---|
| vi | ViSession | This handle identifies your instrument session. vi was obtained from niHSDIO_InitAcquisitionSession. |
| samplesToRead | ViInt32 | Specifies the number of samples to fetch. Default Value: 1000 |
| maxTimeMilliseconds | ViInt32 | Specifies in milliseconds how long to allow the function to complete before
returning a timeout error. A value of -1 causes the function to never timeout. Default Value: 10000 |
| startingRecord | ViInt32 | Specifies the first record you want to fetch. |
| recordsToRead | ViInt32 | Specifies the number of records you want to fetch. |
| waveformData | ViUInt8[] | Returns the array of waveform data that contains the records to fetch. |
| waveformInfo | niHSDIO_wfmInfo * | Returns information about the records. waveformInfo includes an absolute timestamp, relative timestamp, the number of samples fetched, and the dT of the waveform. |