GX5296, GX5961, GX5964, File
Returns the error addresses memory contents.
GtDio6xRealTimeCompareReadErrorAddressMemory (nHandle, dwErrorStart, dwErrorCount, padwErrorStepArray, padwErrorVectorArray, pnStatus)
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. |
dwErrorStart |
DWORD |
Used to specify the beginning error number of the error address memory to query. The valid range is 0 to 1023. |
dwErrorCount |
DWORD |
Used to specify the number of errors to query.The Number or Errors plus the Starting Error must be less than or equal to 1024. |
padwErrorStepArray |
PDWORD |
Used to return an array containing the Steps that generated real time compare errors.The array must have at least as many elements as is specified in the dwErrorCount parameter. |
padwErrorVectorArray |
PDWORD |
Used to return an array contain the Vectors that generated errors.The array must have at least as many elements as is specified in the dwErrorCount parameter. |
pnStatus |
PSHORT |
Returned status: 0 on success, negative value on failure. |
The error address memory records the Step, and Vector address of the first 1024 errors that have occurred during a sequencer Run.
Step: This indicates the Step that was running when the error occurred.
Vector: This indicates the Vector that the error occurred on.
The type of errors that are recorded can be set by calling GtDio6xRealTimeCompareSetErrorAddressMemorySource.
The following reads the first 20 entries from the Error Address Memory:
DWORD adwStepErrorArray[20];
DWORD adwVectorErrorArray[20];
SHORT nStatus;
GtDio6xRealTimeCompareReadErrorAddressMemory(nHandle,
0, 20, adwStepErrorArray, adwVectorErrorArray, &nStatus);