beautypg.com

Navigate through packets – Teledyne LeCroy Sierra SAS_SATA Protocol Analyzer STX API Reference Manual User Manual

Page 152

background image


Sierra SAS/SATA Protocol Suite, STX Software API Reference Manual

How to Navigate through Trace File 152

VARIANT* pStartTime: Start time of a packet

long* pIdleTime: Dummy parameter

long* pDurationTime: Dummy parameter

BOOL* pHasBookmark: Dummy parameter

short* piNumberOfPErrors: Number of protocol error assigned to a packet

VARIANT* pvtPErrorCodeList: CWordArray of protocol error assigned to a

packet

Return Value

Returns result of method, whether called by valid index and layer ID or not.

Description

Call the GetPacketProperties () function of Extraction Interface to obtain

individual packet properties of that particular layer.

Navigate through Packets

Navigating through packets of a loaded trace file can use the GotoPacket function of the

Extraction Interface.

Int nPacketIndex = m_pSASExtraction ->
GotoPacket (iLayerId, nPacketIndexInLayer);

CSerialSCSIExtraction::GotoPacket ()
Prototype

HRESULT GotoPacket(short iLayerID, int nPacketIndexInLayer,

int* pnPacketIndexInResult)

Usage

= ->

GotoPacket (, );

Inputs

Short iLayerId: Identifier of the layer

Int nPacketIndexInLayer: Index of the packet in layer

Return Value Physical Index of the new packet
Description

Call THE GotoPacket () function of the Extraction Interface to navigate

through packets of the loaded trace file.