6 ianalyzer::startrecording, Ianalyzer::startrecording – Teledyne LeCroy USB Analyzer Automation Manual User Manual

Page 15

Advertising
background image

Teledyne LeCroy Automation API Reference Manual for USBTracer, USB Advisor, and Voyager USB Protocol
Suite

15

2.1.6 IAnalyzer::StartRecording


HRESULT StartRecording (

[in] BSTR ro_file_name );


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 the default
recording options.

Return values

ANALYZERCOMERROR_EVENTSINKNOTINSTANTIATED

Event sink was not instantiated.

ANALYZERCOMERROR_UNABLESTARTRECORDING

Unable to start recording.

Remarks


After recording starts, this function returns. The Analyzer continues recording until it is finished

or until a StopRecording method call is performed. During the recording, the events are sent to the
event sink (see the

_IAnalyzerEvents

interface).

The recording options file is the file with extension .rec created by the USB Protocol Suite

application. You can create such a file by selecting Setup

– Recording Options… from the

USB Protocol Suite application menu, changing the recording options in the dialog, and selecting the
Save button.

Example


VBScript:

<OBJECT

RUNAT=Server
ID = Analyzer
CLASSID = "clsid:0B179BB3-DC61-11d4-9B71-000102566088"

>
</OBJECT>

<INPUT TYPE=TEXT VALUE="" NAME="TextRecOptions">

<SCRIPT LANGUAGE="VBScript">
<!--
Sub BtnStartRecording_OnClick

On Error Resume Next

Analyzer.StartRecording TextRecOptions.value

If Err.Number <> 0 Then

MsgBox Err.Number & ":" & Err.Description

End If

End Sub
-->
</SCRIPT>


Advertising