GX5296, GX5961, GX5964
Returns a list of channels that has one or more Real Time Compare errors for the vectors contained within the specified step range.
GtDio6xRealTimeCompareGetFailedChannels (nHandle, nVectorTestFlags, lStepStart, lStepCount, plChannelCount, lFailedVectorAddressesArraySize, palFailedChannels, 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. |
|
nVectorTestFlags |
SHORT |
Used to specify the vector test flags:0. GTDIO6X_RTC_FAILED_CHANNELS_ALL: Channels with any failed vectors. 1. GTDIO6X_RTC_FAILED_CHANNLES_WITH_C_FLAG: Channels only with failed C flag vectors (only GX5961 and GX5964). 2. GTDIO6X_RTC_FAILED_CHANNLES_WITH_E_FLAG: Channels only with failed E flag vectors (only GX5961 and GX5964). |
|
lStepStart |
LONG |
Start step. |
|
lStepCount |
LONG |
Number of steps to search. |
|
plChannelCount |
PLONG |
Returns the number of unique channels found wit failed vectors. |
|
lFailedVectorChannelsArraySize |
LONG |
Specified the failed channel numbers array size. |
|
palFailedChannels |
LONG |
An array returning the failed channel numbers. |
|
pnStatus |
PSHORT |
Returned status: 0 on success, negative value on failure. |
|
This function is like a utility function that helps the user to get the result related to specific channels and steps.
The following example returns all the failed channel with only the failed E flag vectors within all vectors that were assigned to step 0:
SHORT nHandle nStatus;
LONG alFailedChannels [32];
LONG lChannelCount;
GtDio6xRealTimeCompareGetFailedChannels(nHandle, GTDIO6X_RTC_FAILED_CHANNLES_WITH_E_FLAG, 0, 1, &lChannelCount, 32, alFailedChannels, &nStatus);
GtDio6xRealTimeCompareSetErrorAddressMemorySource, GtDio6xRealTimeCompareGetErrorCount, GtDio6xRealTimeCompareReadErrorAddressMemory, GtDio6xGetErrorString