beautypg.com

11 itrace::analyzererrors – Teledyne LeCroy SierraFC Automation API User Manual

Page 38

background image

LeCroy Corporation

SierraFC M8-4 API Reference Manual

Manual Version 1.00

38

4.1.11 ITrace::AnalyzerErrors


HRESULT AnalyzerErrors (

[in] long error_type,
[out, retval] IFCAnalyzerErrors** analyzer_errors );

Retrieves trace file errors. Returns an interface pointer to the FCTraceErrors object

Parameters

error_type

Type of error collection you want to retrieve;
The following values are valid:

ID_FC_SYMBOL_VIOLATION

= 0

ID_FC_DISPARITY_ERROR

= 1

ID_FC_SPACING_ERROR

= 2

ID_FC_ALIGNMENT_ERROR

= 3

ID_FC_DELIMITER_ERROR

= 4

ID_FC_EOF_ERROR

= 5

ID_FC_PRIMITIVE_ERROR

= 6

ID_FC_FRAME_LENGTH_ERROR

= 7

ID_FC_CRC_ERROR

= 8

analyzer_errors

Address of a pointer to the

FCTraceErrors

object interface

Return values

ANALYZERCOMERROR_INVALIDERROR -

invalid error type specified

Remarks

The FCTraceErrors 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.FCAnalyzer")
Set Trace = Analyzer.MakeRecording (CurrentDir & "Input\test_ro.rec")
Set Errors = Trace.AnalyzerErrors (16) 'Bad CRC16

C++:

IFCTrace* sas_trace;


. . .

IFCAnalyzerErrors* 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("SierraFC M8-4 client"), MB_OK );
else
::MessageBox( NULL, er.ErrorMessage(),_T("SierraFC M8-4 client"), MB_OK );
return 1;

}

. . .

analyser_errors->Release();