beautypg.com

4 itrace::exporttotext, Itrace::exporttotext – Teledyne LeCroy USB Analyzer Automation Manual User Manual

Page 46

background image

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

46

3.1.4 ITrace::ExportToText


HRESULT ExportToText (

[in] BSTR file_name,
[in, defaultvalue(-1)] long packet_from,
[in, defaultvalue(-1)] long packet_to );

Exports the trace into a text file and allows you to export a range of packets.

Parameters

file_name

String providing the full pathname to file where trace is exported


packet_from

Beginning packet number when you are exporting a range of packets.
Value

–1 means that the first packet of exported trace would be the first packet

of this trace.


packet_to

Ending packet number when you are exporting a range of packets.
Value

–1 means that the last packet of exported trace would be the last packet

of this trace.

Return values

ANALYZERCOMERROR_UNABLESAVE

Unable to export trace file.

Remarks

Use this method if you want to export a recorded or opened trace into a text file. If display

options apply to this trace (see

ITrace::ApplyDisplayOptions

or

IAnalyzer::LoadDisplayOptions

), then

hidden packets are not exported.

If packet range is specified and it is invalid (for example, packet_to is more than last packet

number in the trace, or packet_from is less than first packet number in the trace, or packet_from is
more than packet_to), then packet range adjusts automatically.

Here is a snippet of an export file for a Bluetooth Trace. A USB Trace file would look similar: