niHSDIO_FetchMultiRecordU16

NI Digital Waveform Generator/Analyzer

niHSDIO_FetchMultiRecordU16

Specific Function

C Function Prototype

ViStatus niHSDIO_FetchMultiRecordU16 (ViSession vi, ViInt32 samplesToRead, ViInt32 maxTimeMilliseconds, ViInt32 startingRecord, ViInt32 recordsToRead, ViUInt16[] waveformData, niHSDIO_wfmInfo * waveformInfo);

Purpose

Fetches the data as a two-dimensional array of unsigned 16-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 ViUInt16[] 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.

Return Value