Teledyne LeCroy UWBTracer Automation Manual - Manual (Page 35)

LeCroy UWBTracer Automation API Reference Manual Manual Version 3.02
31
4.1.3 IUwbTrace::Save
HRESULT Save (
[in] BSTR file_name,
[in, defaultvalue(-1)] long packet_from,
[in, defaultvalue(-1)] long packet_to );
Saves trace into file, allows to save a range of packets
Parameters
file_name String providing the full pathname to file where trace is saved
packet_from Beginning packet number when you are saving a range of packets; value –1
means that the first packet of saved trace would be the first packet of this trace
packet_to Ending packet number when you are saving a range of packets; value –1 means
that the last packet of saved trace would be the last packet of this trace
Return values
ANALYZERCOMERROR_UNABLESAVE Unable to save trace file
Remarks
Use this method if you want to save recorded or opened trace into the file. If the display options applied to
this trace (see
IUwbTrace::ApplyDisplayOptions , IUwbAnalyzer::LoadDisplayOptions )
then hidden packets would not be saved.
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.