Teledyne LeCroy Automation API for Bluetooth Analyzers - Manual (Page 24)

18
Automation API for CATC Bluetooth Analyzers CATC Ver. 1.40
2.3.9 IAnalyzer::MakeRecording
Makes recording with specified recording options file
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 BTTrace object primary interface
Return values
Remarks
This method acts like the 'StartRecording' method but will not return until recording is com-
pleted.
BTTrace object is created via this method call, if call was successful.
Recording options file is the file with extension .rec created by BTAnalyzer application.
You can create such file when you select “Setup – Recording Options…” from BTAna-
lyzer 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.Merlin")
Set Trace = Analyzer.MakeRecording (CurrentDir & "Input\test_ro.rec")
C++:
IDispatch* trace;
IBTAnalyzer* bt_analyzer;
BSTR ro_file_name;
HRESULT hr;
. . .
try
{
trace = bt_analyzer->MakeRecording( ro_file_name )
}
catch ( _com_error& er)
{
if (er.Description().length() > 0)
::MessageBox( NULL, er.Description(), _T("BTAnalyzer client"),
MB_OK );
else
::MessageBox( NULL, er.ErrorMessage(), _T("BTAnalyzer client"),
MB_OK );
return 1;
}
HRESULT MakeRecording (
[in] BSTR ro_file_name,
[out, retval] IDispatch** trace );