beautypg.com

8 itrace::reporttrafficsummary, Itrace::reporttrafficsummary – Teledyne LeCroy USB Analyzer Automation Manual User Manual

Page 53

background image

Teledyne LeCroy Automation API Reference Manual for USBTracer, USB Advisor, and Voyager USB Protocol
Suite

53

3.1.8 ITrace::ReportTrafficSummary


HRESULT ReportTrafficSummary(

[in] BSTR file_name );

Saves trace traffic summary information into the specified text file.


Parameters

file_name

String providing the full pathname to file where traffic summary report is
created

Return values

ANALYZERCOMERROR_UNABLESAVE

Unable to create or save traffic summary report.

Remarks

Creates traffic summary report file, if necessary. Stores traffic summary in the specified file. Here is an
example of data stored using this method call:

Example

WSH:

Set Analyzer = WScript.CreateObject("CATC.USBTracer")
CurrentDir = Left(WScript.ScriptFullName, InstrRev(WScript.ScriptFullName, "\"))
Set Trace = Analyzer.MakeRecording (CurrentDir & "Input\test_ro.rec")
Trace.ReportTrafficSummary CurrentDir & "Output\traffic_summary.txt"


C++:

IUsbTrace* usb_trace;
TCHAR file_name[_MAX_PATH];

. . .

try

{

usb_trace->ReportTrafficSummary( file_name );

}
catch ( _com_error& er)
{

if (er.Description().length() > 0)
::MessageBox( NULL, er.Description(), _T("UsbAnalyzer client"), MB_OK );
else
::MessageBox( NULL, er.ErrorMessage(), _T("UsbAnalyzer client"), MB_OK );
return 1;

}