beautypg.com

Teledyne LeCroy Sierra SAS_SATA Protocol Analyzer STX API Reference Manual User Manual

Page 89

background image


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

Using Initiator/Host Emulator API Functions 89

Example

m_pIInitiatorExerciserErrorInjection-> ErInjSetFrameErrorType (
iLayerID, nCommandIndex,
m_bFrameType, &nErrorCode);


CExerciserEngine::SetOutGoingErrorAttribute ()
Prototype

HRESULT SetOutGoingErrorAttribute (short iLayerId, int nPacketIndexInLayer,

BOOL bEnable, int nFrameType, short iFrameNumberInCommand,

int *pnErrorCode);

Usage

-> SetOutGoingErrorAttribute

(, ,

, ,

);

Inputs

Short iLayerId: layer ID of the packet

Int nPacketIndexInLayer: Index of the packet in layer

BOOL bEnable: Specifies whether to enable error injection on outgoing frame or

not

Int nFrameType: Type of the frame to set error injection

Short iFrameNumberInCommand: Number of the frame in command list

Return Value Returns success/ failure status of the method in the form of an error code.
Description

Call SetOutGoingErrorAttribute () of Exerciser Engine to set all required

parameters before setting Error Injection for individual out going frame options.


Below are the function prototypes corresponding to every option of Error Injection on an

Outgoing Frame:

STDMETHOD

(ErInjSetDelayResponseToHold) (

/*[in]*/

short

iLayerId,

/*[in]*/

int

nPacketIndexInLayer,

/*[in]*/

BOOL bEnable,

/*[out]*/

int

* pnRetVal);

STDMETHOD

(ErInjSetNoWTRM) (

/*[in]*/

short

iLayerId,

/*[in]*/

int

nPacketIndexInLayer,

/*[in]*/

BOOL bEnable,

/*[out]*/

int

* pnRetVal);