Error injection on packets in initiator – Teledyne LeCroy Sierra SAS_SATA Protocol Analyzer STX API Reference Manual User Manual
Page 85

Sierra SAS/SATA Protocol Suite, STX Software API Reference Manual
Using Initiator/Host Emulator API Functions 85
Error Injection on Packets in Initiator
To set an Error Injection on packets in Initiator, get an Instance of Initiator Error Injection
Interface. First, declare an Instance variable for the initiator Error Injection, and then Query it
using the QueryInterface () function of the Exerciser Engine.
(Refer to ATAPISample -> ATAPISampleDoc.h -> CATAPISampleDoc ().)
(Refer to ATAPISample -> ATAPISampleDoc.cpp -> OnNewDocument ().)
IInitiatorExerciserErrorInjection
*m_pIInitiatorExerciserErrorInjection;
m_pExerciserEngine-> QueryInterface (
__uuidof(IInitiatorExerciserErrorInjection),
&m_pIInitiatorExerciserErrorInjection);
After obtaining a hold to the Error Injection interface, use its methods to set Error Injection on
Outgoing frames, on Incoming frames, and on Outgoing Open Error.
QueryInterface ()
Prototype
HRESULT QueryInterface (REFIID riid, void** ppv);
Usage
Inputs
REFIID riid: ID of a reference object of an Interface
Void** ppv: Void reference to hold the instantiated address of the interface
Return Value None
Description Call QueryInterface () to query the Initiator Error Injection Interface.