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

Teledyne LeCroy SASAnalyzer Object
18 Automation API for Teledyne LeCroy SAS/SATA Protocol Suite
ISASAnalyzer::MakeRecording
HRESULT MakeRecording (
[in] BSTR ro_file_name,
[out, retval] IDispatch** trace );
Makes recording with the specified recording options file.
Parameters
ro_file_name String providing the full pathname to a recording options file.
trace Address of a pointer to the SASTrace object interface
Return Values
ANALYZERCOMERROR_UNABLESTARTRECORDING Unable to start recording
Remarks
This method acts like the StartRecording method but will not return until recording is
completed. The SASTrace object is created via this method call, if the call was successful.
The recording options file is the file with extension .sac created by the SAS/SATA
Protocol Suite application. You can create this file when you select File –> Protocol
Analyzer… from the SAS Protocol Suite application menu, change the recording options in
the Protocol Analyzer project, and select the Save… button.
Example
WSH:
CurrentDir = Left(WScript.ScriptFullName,
InstrRev(WScript.ScriptFullName, "\"))
Set Analyzer =
WScript.CreateObject("Lecroy.SASAnalyzer")
Set Trace = Analyzer.MakeRecording (CurrentDir &
"Input\test_ro.sac")
C++:
IDispatch* trace;
ISASAnalyzer* sas_analyzer;
BSTR ro_file_name;
HRESULT hr;
. . .