Teledyne LeCroy SAS_SATA Tracer_Trainer Automation API Manual - Manual (Page 42)

LeCroy Corporation Automation API for SAS/SATATracer/Trainer Manual Version 1.11
42
4.1.11 ITrace::AnalyzerErrors
HRESULT AnalyzerErrors (
[in] long error_type,
[out, retval] ISASAnalyzerErrors** analyzer_errors );
Retrieves trace file errors. Returns an interface pointer to the SASTraceErrors object
Parameters
error_type Type of error collection you want to retrieve;
The following values are valid:
0 - OOB Sequence Error
1 - Symbol violation
2 - Disparity Error
3 - Alignment Error
4 - Signaling Latency Error
5 - Invalid State Transition unexpected primitive
6 - Invalid State Transition Primitive Response Time-out
7 - FIS Type Error
8 - FIS Length Error
9 - FIS Direction Error
10 - CRC Error
analyzer_errors Address of a pointer to the SASTraceErrors object interface
Return values
ANALYZERCOMERROR_INVALIDERROR - invalid error type specified
Remarks
The SASTraceErrors object is created by this method call, if the call was successful.
Example
WSH:
CurrentDir = Left(WScript.ScriptFullName, InstrRev(WScript.ScriptFullName, "\"))
Set Analyzer = WScript.CreateObject("LeCroy.SASAnalyzer")
Set Trace = Analyzer.MakeRecording (CurrentDir & "Input\test_ro.rec")
Set Errors = Trace.AnalyzerErrors (16) 'Bad CRC16
C++:
ISASTrace* sas_trace;
. . .
ISASAnalyzerErrors* analyser_errors;
try
{
analyser_errors = sas_trace->AnalyzerErrors(error_type).Detach();
}
catch (_com_error& er)
{
if (er.Description().length() > 0)
::MessageBox( NULL, er.Description(), _T("SASTracer client"), MB_OK );
else
::MessageBox( NULL, er.ErrorMessage(),_T("SASTracer client"), MB_OK );
return 1;
}
. . .
analyser_errors->Release();