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

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;
}