GtDio6xRealTimeCompareGetErrorCount

Applies To

GX5296, GX5961, GX5964, File

Purpose

Returns the number of errors generated in the last sequencer run.

Syntax

GtDio6xRealTimeCompareGetErrorCount(nHandle, plErrorAddressCount, plErrorCount, pnStatus)

Parameters

Name
Type
Comments
nHandle
SHORT
Session identifier:

     Board handle is used when communicating with the hardware. The Board handle session identifier is returned by calling GtDio6xInitialize or GtDio6xSetupInitialization.

     File handle is used when communicating with a file. The File handle session identifier is  returned by calling GtDio6xFileOpen.

plErrorAddressCount
PLONG
Returns number of error address memory entries (unique step/vector addresses).
plErrorVectorCount
PLONG
Returns the number of vectors that have caused an error (non-unique step/vector addresses).
pnStatus
PSHORT
Returned status: 0 on success, negative value on failure.

Comments

The error results consist of the following:

     Error Address Count - The number of error address memory locations recorded in the previous sequencer run. These error results require that the error basis be set using the GtDio6xRealTimeCompareSetErrorAddressMemorySource function.

     Error Count - Returns the number of vectors that did not match in the previous sequence run. These error results require that the error basis be set using the GtDio6xRealTimeCompareSetErrorCountSource function.

Example

The following gets the error flags set during the last primary sequence run:

 

LONG lErrorAddressCount, lErrorCount;

SHORT nStatus;

 

GtDio6xRealTimeCompareGetErrorCount(nHandle, &lErrorAddressCount, &lErrorCount, &nStatus);

 

See Also

GtDio6xSequencerSetRecordParameters, GtDio6xStepSetRecordMode, GtDio6xGetErrorString