Gx3788AnalogInScanReadMemoryVoltages

Purpose

Read recorded voltage samples from the last scan operation.

Syntax

Gx3788AnalogInScanReadMemoryVoltages (nHandle, dwMemoryStart, dwCount, padData, pnStatus)

Parameters

Name
Type
Comments
nHandle
SHORT
Handle to a GX3788 board.
dwMemoryStart
DWORD
The starting offset in memory for the scan sample memory read operation.
dwCount
DWORD
The number of samples to read from memory.
padData
PDOUBLE
Return the samples in the form of voltages within an array.
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Comments

The sample memory contains the captured voltage samples after a scan operation has completed. This function returns the samples in the form of voltages. Each set of samples (acquired from one or more channels as defined in the channel list), are stored sequentially in memory. For example, if the channel list defines channels 6, 8, 3, and 4, and the sample count was set to 3, then the sample memory will contain voltage samples in the following order:

6,8,3,4...6,8,3,4...6,8,3,4.

Note: see the Gx3788AnalogInScanStart() API for a complete example code.

Example

The following example reads 10 samples from memory start at offset 0:

 

SHORT nStatus;

DOUBLE adData[10];

Gx3788AnalogInScanReadMemoryVoltages (nHandle, 0, 10, adData, &nStatus);

 

See Also

Gx3788AnalogInMeasureChannel, Gx3788AnalogInSetGroundSource, Gx3788Reset, Gx3788AnalogInScanGetLastRunCount, Gx3788AnalogInScanIsRunning, Gx3788AnalogInScanReadMemoryRawData, Gx3788AnalogInScanSetChannelListIndex, Gx3788AnalogInScanSetCount, Gx3788AnalogInScanSetSampleRate,

Gx3788AnalogInScanStart, GxFpgaGetErrorString