Data Sheet

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

Suite

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>

<!--

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>