Teledyne LeCroy FireInspector Automation Application Programming Interface - Manual (Page 22)

18
FireInspector Automation User’s Manual CATC Version 1.0
2.3.8 IAnalyzer::MakeRecording
Makes recording with specified recording options file.
Syntax
HRESULT MakeRecording (
[in] BSTR ro_file_name,
[out, retval] IDispatch** trace );
Parameters
• ro_file_name – string providing the full pathname to recording options file; if the
parameter is omitted then recording starts with default recording options
• trace – address of a pointer to the FwTrace object primary interface
Return values
Remarks
This method acts like the
' StartRecording ' method but will not return until recording
is completed.
FwTrace object is created via this method call, if call was successful.
Recording options file is the file with extension .rec created by FireInspector application.
You can create such file when you select Setup > Recording Options... from FireInspector
application menu, change the recording options in the appeared dialog and select
“Save…” button.
Example
WSH:
CurrentDir = Left(WScript.ScriptFullName,
InstrRev(WScript.ScriptFullName, "\"))
Set Analyzer = WScript.CreateObject("CATC.FwAnalyzer")
Set Trace = Analyzer.MakeRecording (CurrentDir &
"Input\test_ro.rec")
C++:
IDispatch* trace;
IFwAnalyzer* fw_analyzer;
BSTR ro_file_name;
HRESULT hr;
. . .
try
{
trace = fw_analyzer->MakeRecording( ro_file_name )
}
catch ( _com_error& er)
{
if (er.Description().length() > 0)
::MessageBox( NULL, er.Description(), _T("FwAnalyzer
client"), MB_OK );
else