Teledyne LeCroy SAS_SATA Tracer_Trainer Automation API Manual - Manual (Page 43)

LeCroy Corporation Automation API for SAS/SATATracer/Trainer Manual Version 1.11
43
4.2 ISASTrace Interface
The ISASTrace interface is a primary dual interface for the SASTrace object.
This interface is derived from the ITrace interface.
The ISASTrace interface implements all methods from the ITrace interface plus the
following: GetBusPacket
4.2.1 ISASTrace::GetBusPacket
HRESULT GetBusPacket (
[in] long packet_number,
[out, retval] IDispatch** packet )
Retrieves the interface for a packet within a trace.
Parameters
packet_number
Zero based number of packet to retrieve
packet
Address of a pointer to the SASPacket object interface
Return values
Remarks
The SASPacket object is created by this method call, if the call was successful.
Example
WSH:
C++:
ISASTrace* sas_trace;
. . .
IDispatch* packet;
try
{
packet = sas_trace->GetBusPacket( GetDlgItemInt(IDC_PACKET_NUMBER)
).Detach();
}
catch ( _com_error& er)
{
if (er.Description().length() > 0)
::MessageBox( NULL, er.Description(), _T("SASTracer client"), MB_OK );
else
::MessageBox( NULL, er.ErrorMessage(),_T("SASTracer client"), MB_OK );
return 1;
}
ISASPacket* custom_packet;
HRESULT hr = packet->QueryInterface( IID_ISASPacket, (void**)&custom_packet );
packet->Release();