4 itrace::exporttotext, Itrace::exporttotext – Teledyne LeCroy USB Analyzer Automation Manual User Manual
Page 46
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
), 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: