Teledyne LeCroy UWBTracer Automation Manual - Manual (Page 34)

LeCroy UWBTracer Automation API Reference Manual Manual Version 3.02
30
4.1.2 IUwbTrace::ApplyDisplayOptions
HRESULT ApplyDisplayOptions (
[in] BSTR do_file_name );
Applies specified display options to the trace
Parameters
do_file_name String providing the full pathname to display options file
Return values
ANALYZERCOMERROR_UNABLELOADDO Unable to load display options file
Remarks
Use this method if you want to filter traffic of some type in the recorded or opened trace.
Display options file is the file with extension .opt created by UwbAnalyzer application. You can create
such file when you select “Setup – Display Options…” from UwbAnalyzer application menu, change the
display options in the appeared dialog and select “Save…” button.
Example
WSH:
Set Analyzer = WScript.CreateObject("CATC.UwbAnalyzer")
CurrentDir = Left(WScript.ScriptFullName, InstrRev(WScript.ScriptFullName, "\"))
Analyzer.StartRecording (CurrentDir & "test_ro.rec")
'... do something
Set Trace = Analyzer.StopRecordingAndWaitForTrace
Trace.ApplyDisplayOptions CurrentDir & "Input\test_do.opt"
Trace.Save CurrentDir & "Output\saved_file.uwb"
C++:
IUwbTrace*
UWB_trace;
TCHAR file_name[_MAX_PATH];
. . .
try
{
UWB_trace->ApplyDisplayOptions( file_name );
}
catch ( _com_error& er)
{
if (er.Description().length() > 0)
::MessageBox( NULL, er.Description(), _T("UwbAnalyzer client"), MB_OK );
else
::MessageBox( NULL, er.ErrorMessage(), _T("UwbAnalyzer client"), MB_OK );
return 1;
}