Teledyne LeCroy Automation API for Bluetooth Analyzers - Manual (Page 41)

35
Automation API for CATC Bluetooth Analyzers CATC Ver. 1.40
2.4.4 ITrace::ExportToText
Exports trace into text file, allows 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 recorded or opened trace into the text file. If the dis-
play options applied to this trace (see ITrace::ApplyDisplayOptions, IAnalyzer::LoadDisplayOptions )
then hidden packets would not be exported.
If packet range is specified and it is invalid ( for example packet_to is more then last
packet number in the trace, or packet_from is less then first packet number in the trace, or
packet_from is more then packet_to ) then packet range will be adjusted automatically.
Here is a snippet of export file:
File \\sw-eng10.catc.com\TraceFiles\ObexSample.blt.
From Packet #15 to Packet #19.
Packet#
_______|___________________________________________________________________
____
15_____| T(S) Freq(2434) Addr(0x7) DM1(0x3) L_CH(...UA/UI) L2FL(1) Len(0)
_______| CRC(0x57BB) Ack'd(Yes) Idle(455.000 µs) Time Stamp(00010.831 4575)
_______|___________________________________________________________________
____
16_____| T(M) Freq(2465) Addr(0x7) DM1(0x3) L_CH(...UA/UI) L2FL(1) Len(0)
_______| CRC(0x57BB) Ack'd(Yes) Idle(453.100 µs) Time Stamp(00010.832 0835)
_______|___________________________________________________________________
____
17_____| T(S) Freq(2432) Addr(0x7) DM1(0x3) L_CH(...UA/UI) L2FL(1) Len(0)
_______| CRC(0x57BB) Ack'd(Yes) Idle(455.000 µs) Time Stamp(00010.832 7076)
_______|___________________________________________________________________
____
18_____| T(M) Freq(2433) Addr(0x7) DM1(0x3) L_CH(LM) L2FL(1) Len(1)
_______| Data(1 byte) CRC(0xF04F) Ack'd(Yes) Idle(438.000 µs)
_______| Time Stamp(00010.833 3336)
HRESULT ExportToText (
[in] BSTR file_name,
[in, defaultvalue(-1)] long packet_from,
[in, defaultvalue(-1)] long packet_to );