niHSDIO_FetchMultiRecordU32

NI Digital Waveform Generator/Analyzer

niHSDIO_FetchMultiRecordU32

Specific Function

C Function Prototype

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

Purpose

Fetches the data as a two-dimensional array of unsigned 32-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.
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 time out.
startingRecord ViInt32 Specifies the the first record you want to fetch.
recordsToRead ViInt32 Specifies the number of records you want to fetch.
waveformData ViUInt32[] 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