Teledyne LeCroy UWBTracer Automation Manual - Manual (Page 38)

LeCroy UWBTracer Automation API Reference Manual Manual Version 3.02
34
4.1.5 IUwbTrace::ExportToText
HRESULT ExportToText (
[in] BSTR file_name,
[in, defaultvalue(-1)] long packet_from,
[in, defaultvalue(-1)] long packet_to );
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 display options
applied to this trace (see IUwbTrace::ApplyDisplayOptions
,
IUwbAnalyzer::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 C:\UWB Traces\RealTrace.uwb.
From Frame #0 to Frame #3.
Frame#
_______|_______________________________________________________________________
Frame(0) PHY MAC Control Dest ID(0x0088) Src ID(0xBEEF) Ctl
_______| Data(36 bytes) Rpt Frm Duration(8.853 µs) PHY_ACT( 13.331 µs)
_______| Delta Time(171.125 µs) Idle(157.794 µs) Time Stamp(2.370813167)
_______|_______________________________________________________________________
Frame(1) PHY MAC Data Dest ID(0x0000) Src ID(0xBEEF) Data(258 bytes) Rpt
_______| Frm Duration( 42.153 µs) PHY_ACT( 47.076 µs) Delta Time( 40.114 ms)
_______| Idle( 40.067 ms) Time Stamp(2.370984292)
_______|_______________________________________________________________________
Frame(2) PHY MAC Control Dest ID(0x0088) Src ID(0xBEEF) Ctl
_______| Data(36 bytes) Rpt Frm Duration(8.853 µs) PHY_ACT( 13.316 µs)
_______| Delta Time(165.185 µs) Idle(151.869 µs) Time Stamp(2.411098512)
_______|_______________________________________________________________________
Frame(3) PHY MAC Data Dest ID(0x0000) Src ID(0xBEEF) Data(258 bytes) Rpt
_______| Frm Duration( 42.153 µs) PHY_ACT( 47.076 µs) Delta Time( 39.916 ms)
_______| Idle( 39.869 ms) Time Stamp(2.411263697)
_______|_______________________________________________________________________