Addtest, Runcompliance, Changegtr03params – Teledyne LeCroy Sierra SAS_SATA Protocol Analyzer STX API Reference Manual User Manual
Page 175
Sierra SAS/SATA Protocol Suite, STX Software API Reference Manual
STCompliance API 175
AddTest
This function adds compliance tests.
AddTest (int nTestID,
BOOL* pbRetVal)
nTestID: Is the test ID. A list of available tests and their IDs is in
pbRetVal: Is the return value of the function.
RunCompliance
This function runs STCompliance and generates results.
RunCompliance (BOOL* pbRetVal);
pbRetVal: Is the return value of the function.
ChangeGTR03Params
This function changes the settings of the GTR-03 test. If you do not call this function, the system
uses the default settings.
ChangeGTR03Params (BSTR bstrGTR03AddressRange,
int nATAPIMediaType,
DWORD dwTrackSize,
int nLogicalBlockSize,
BOOL* pbRetVal)
bstrGTR03AddressRange: Specifies the Logical Block Address of the device for WRITE/READ
DMA commands. The system issues a pair of WRITE/READ DMA commands with 4 KB payload
for five iterations, incrementing the LBA by 4 KB, and another pair of WRITE/READ DMA
commands with 16 KB payload for five iterations, incrementing the LBA by 16 KB.
nATAPIMediaType: Applies only to ATAPI devices and specifies the media type that ATAPI
devices have inside. Default value is
MEDIA_TYPE_READ_ONLY.
A list of the possible values
for this parameter is at the end of this section in
nLogicalBlockSize: Applies only to ATAPI devices and calculates Transfer Length for Read(10) or
Read CD commands. The system executes the test twice, first with minimum transfer length
equal to 1 (2 KB) and again with transfer length equal to 16384 / nLogicalBlockSize (16 KB).
pbRetVal: Is the return value of the function.