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

Page 102

Advertising
background image


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

Using Target/Device Emulator API Functions 102

m_pITargetEmulator -> SetFieldStream (0, 2, ET_HEX, “1”);


In an Identify Device Page of a SATA project, to change “General Configuration Bit

Information” from default (0000) to “0110”, use:

m_pITargetEmulator -> SetIdentifyDeviceFieldStream (0, ET_HEX,
“0110”);

CTartgetEmulEngine::SetFieldStream ()
Prototype

HRESULT SetFieldStream (int nPageIndex, int nFieldIndex, RadixEnum eRadix,

BSTR bstrFieldData, int *pnErrorCode);

Usage

<Target Emulator Engine Object> -> SetFieldStream (<Index of the SAS Page>,

<Index of field in that particular page>, <Format of field stream>,

<BSTR form of new field data>)

Inputs

Int nPageIndex: Index of the SCSI Page of SAS Project

Int nFieldIndex: Index of the field in the current page

RadixEnum eRadix: Format of the field stream

BSTR bstrFieldData: New data of the field in BSTR format

Int * pnErrorCode: Pointer to an integer to hold returning error value, if any

Return Value None
Description Call the SetFieldStream () function of Target Emulator Engine to set field

data of a page in a radix format in a stream.


CTartgetEmulEngine::SetIdentifyDeviceFieldStream ()
Prototype

HRESULT SetIdentifyDeviceFieldStream (int nFieldIndex, RadixEnum eRadix,

BSTR bstrFieldData, int *pnErrorCode);

Usage

<Target Emulator Engine Object> -> SetIdentifyDeviceFieldStream (

<Index of field in Identify Device page>, <Format of field stream>,

<BSTR form of new field data>)

Inputs

Int nFieldIndex: Index of the field in the Identify Device page

RadixEnum eRadix: Format of the field stream

BSTR bstrFieldData: New data of the field in BSTR format

Int * pnErrorCode: Pointer to an integer to hold returning error value, if any

Return Value None
Description Call the SetIdentifyDeviceFieldStream () function of Target Emulator Engine to

set field data of Identify Device page in a SATA Project.

Advertising