beautypg.com

1 iuwbtrace3::gotounit, Iuwbtrace3::gotounit – Teledyne LeCroy UWBTracer Automation Manual User Manual

Page 52

background image

LeCroy

UWBTracer Automation API Reference Manual

Manual Version 3.02

48

4.3.1 IUwbTrace3::GotoUnit


HRESULT GotoUnit ([in] long level, [in] long index );


Instructs the trace view to jump to the specified transaction unit.

Parameters

level

Transaction level

Possible

values

are:

0

=

WiMedia

frames

2 = WUSB transactions

3 = WUSB transfers

4

=

WUSB

WireAdapter

segments

5

=

WUSB

WireAdapter

transfers

index

Index of unit inside of transaction level

Return values

ANALYZERCOMERROR_INVALIDPACKETNUMBER

Unable to jump to the specified transaction unit:
Either transaction level or transaction index
is invalid.

Example


WSH:

Set Analyzer = WScript.CreateObject("CATC.UwbAnalyzer")
CurrentDir = Left(WScript.ScriptFullName, InstrRev(WScript.ScriptFullName, "\"))
Analyzer.StartRecording (CurrentDir & "test_ro.rec")
'... do something
Set Trace = Analyzer.StopRecordingAndWaitForTrace

Trace.GotoUnit( 3, 2 ) ' jumps to WUSB transfer #2


C++:
IUwbTrace3*

Uwb_trace;

. . .


try
{

int level = 3; // WUSB Transfers

int index = 2;
Uwb_trace ->GotoUnit( 3, 2 );

}
catch ( _com_error& er)
{

if (er.Description().length() > 0)

::MessageBox( NULL, er.Description(), _T("UwbAnalyzer client"), MB_OK );

else

::MessageBox( NULL, er.ErrorMessage(), _T("UwbAnalyzer client"), MB_OK );

return 1;

}