Teledyne LeCroy UWBTracer Automation Manual - Manual (Page 21)

LeCroy UWBTracer Automation API Reference Manual Manual Version 3.02
17
3.1.9 IUwbAnalyzer::MakeRecording
HRESULT MakeRecording (
[in] BSTR ro_file_name,
[out, retval] IDispatch** trace );
Makes a recording with the 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 UwbTrace object primary interface
Return values
Remarks
This method acts like the
StartRecording method but will not return until recording completes.
The UwbTrace object is created via this method call, if call was successful.
Recording options file is the file with extension .rec created by the UWBTracer application. You can
create such a file when you select Setup – Recording Options from the UWBTracer application menu,
change the recording options in the dialog, and select the Save button.
Example
WSH:
CurrentDir = Left(WScript.ScriptFullName, InstrRev(WScript.ScriptFullName, "\"))
Set Analyzer = WScript.CreateObject("CATC.UwbAnalyzer")
Set Trace = Analyzer.MakeRecording (CurrentDir & "Input\test_ro.rec")
C++:
IDispatch* trace;
IUwbAnalyzer* UWB_analyzer;
BSTR ro_file_name;
HRESULT hr;
. . .
try
{
trace = UWB_analyzer->MakeRecording( ro_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;
}
// query for VTBL interface
IUwbTrace* UWB_trace;
hr = trace->QueryInterface( IID_IUwbTrace, (LPVOID *)&UWB_trace );
trace->Release();