Data Sheet

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

Suite

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: