Teledyne LeCroy SAS_SATA Automation API manual - Manual (Page 60)

Teledyne LeCroy SASTrace Object
54 Automation API for Teledyne LeCroy SAS/SATA Protocol Suite
ITrace::ApplyDisplayOptions
HRESULT ApplyDisplayOptions (
[in] BSTR do_file_name );
Applies the specified display options to the trace.
Parameters
do_file_name String providing the full pathname to the display options file
Return values
ANALYZERCOMERROR_UNABLELOADDO Unable to load the display options file
Remarks
Use this method to filter traffic of some type in the recorded or opened trace.
The display options file is the file with extension .sfl created by the filter dialog.
Note: This does not work on Multisegment traces.
Example
WSH:
Set Analyzer =
WScript.CreateObject("LeCroy.SASAnalyzer")
CurrentDir = Left(WScript.ScriptFullName,
InstrRev(WScript.ScriptFullName, "\"))
Set Trace = Analyzer.MakeRecording (CurrentDir &
"Input\test_ro.sac ")
Trace.ApplyDisplayOptions CurrentDir &
"Input\test_do.slf"
Trace.Save CurrentDir &
"Output\saved_file.scs"
C++:
ISASTrace* sas_trace;
TCHAR file_name[_MAX_PATH];
. . .
try
{
sas_trace->ApplyDisplayOptions( file_name );
}
catch (_com_error& er)
{
if (er.Description().length() > 0)