beautypg.com

7 ianalyzer::startrecording, Ianalyzer::startrecording, Catc ver. 1.40 – Teledyne LeCroy Automation API for Bluetooth Analyzers User Manual

Page 21

background image

15

Automation API for CATC Bluetooth Analyzers

CATC

Ver. 1.40

2.3.7 IAnalyzer::StartRecording

Starts recording with specified recording options

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

Return values

ANALYZERCOMERROR_EVENTSINKNOTINSTANTIATED

-

event sink was not instantiated

ANALYZERCOMERROR_UNABLESTARTRECORDING

-

unable to start recording

Remarks

After recording starts this function will return. Analyzer continues recording until it is fin-

ished or until “

StopRecording

” method call is performed. During the recording the events are

send to event sink (see

_IAnalyzerEvents

interface).

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

VBScript:

RUNAT=Server

ID = Analyzer

CLASSID = "clsid:0B179BB3-DC61-11d4-9B71-000102566088"

>

C++:

IBTAnalyzer* bt_analyzer;

BSTR ro_file_name;

. . .

HRESULT StartRecording (

[in] BSTR ro_file_name );