STS8200编程手册学习3-测试参数相关函数

提示：文章写完后，目录可以自动生成，如何生成可参考右边的帮助文档

---

三、测试参数相关函数

1、SetTestResult ()

设置参数测试结果。

int SetTestResult(short sSiteID,short sSubUnitID,double dResult);

sSiteID
设置值对应的工位数， 0 代表 Site1， 1 代表 Site2……
sSubUnitID
设置值对应的子单元数， 0 代表单元 1， 1 代表单元 2……
dResult
设置的结果值。

Example
例 1： dvi0 的测流结果赋值给参数 Icc，并将 Icc 的显示结果转化为 mA。

dvi0.MeasureVI(MI, 100, 30);
for (i=0; i<SITENUM; i++)
{
	adresult[i]=dvi0.GetMeasResult(i);
	Icc->SetTestResult(i, 0, adresult[i]*1000);
}

2、GetTestResult ()

获取参数的测试结果。

double GetTestResult(short sSiteID,short sSubUnitID);

double result=param-> GetTestResult(0,0);

3、SetResultRemark ()

设置参数测试结果的注释信息。

int SetResultRemark(short sSiteID,short sSubUnitID,LPCTSTR lpszremark);

dvi0.MeasureVI(MI, 100, 30);
for (i=0; i<SITENUM; i++)
{
	adresult[i]=dvi0.GetMeasResult(i);
	Icc->SetTestResult(i, 0, adresult[i]*1000);
	Icc->SetResultRemark(i, 0, "Icc_5V");
}

1. 显示注释信息，需选中测试主界面 Options→View→Show Comment Text in result 选项，并合理设置 Text 的长度。

4、GetResultRemark ()

获取函数测试结果的注释信息。

short GetResultRemark(short sSiteID,short sSubUnitID,LPTSTR lpszResultRemark,DWORD cbBuf);

sSiteID
注释信息对应的工位数， 0 代表 Site1， 1 代表 Site2……
sSubUnitID
注释信息对应的子单元数， 0 代表单元 1， 1 代表单元 2……
lpszResultRemark
保存注释信息的字符串首地址。
cbBuf
保存注释信息的字符串的长度。

char sRemark[50];
memset(sRemark,0,50);
param-> GetResultRemark (0,0,sRemark,50);

5、GetMinLimit ()

获取参数下限值。

6、GetMaxLimit ()

获取参数上限值。

7、GetSubUnitsCount ()

获取参数的子单元数。

short subUnitCnt=param-> GetSubUnitsCount ();

8、GetDispFormat ()

获取测试结果的显示格式。

short GetDispFormat(LPTSTR lpszDispFormat,DWORD cbBuf);

9、GetDescription ()

获取参数的描述信息。

short GetDescription(LPTSTR lpszDescription,DWORD cbBuf);

lpszDescription
用于保存参数描述信息的字符串首地址。
cbBuf
用于保存参数描述信息字符串空间的大小。

char sDescription[50];
memset(sDescription,0,50);
param-> GetDescription (sDescription,50);

10、GetConditionsCnt ()

获取测试条件个数。

short CondtionCnt=param-> GetConditionsCnt();

11、GetConditionDispName ()

获取条件显示名。

short GetConditionDispName(const int index,LPTSTR lpszCondName,DWORD cbBuf);

index
测试条件的序列号，从 0 开始。
lpszCondName
用于保存条件显示名的字符串首地址。
cbBuf
用于保存条件显示名字符串空间的大小。

函数调用成功返回 0；返回正整数表示 cbBuf 值比需要的空间值小，返回值为实际需要的空间大小；返回负数表示操作失败。
Example

char sCondName[50];
memset(sCondName,0,50);
param-> GetConditionDispName (0,sCondName,50);

12、GetConditionSymbol ()

获取条件别名。

short GetConditionSymbol(int index,LPTSTR lpszCondSymbol,DWORD cbBuf);

short GetConditionSymbol(LPCTSTR lpszCondName,LPTSTR lpszCondSymbol,DWORD cbBuf);

index
测试条件的序列号，从 0 开始。
lpszCondName
测试条件名。
lpszCondSymbol
用于保存条件别名的字符串首地址。
cbBuf
用于保存条件别名字符串空间的大小。

函数调用成功返回 0；返回正整数表示 cbBuf 值比需要的空间值小，返回值为实际需要的空间大小；返回负数表示操作失败。

char sCondSymbol[50];
memset(sCondSymbol,0,50);
param-> GetConditionSymbol (0,sCondSymbol,50);
param-> GetConditionSymbol ("Voltage",sCondSymbol,50);

13、GetConditionShowKind ()

返回测试条件的显示类型。

BYTE GetConditionShowKind(int index);

BYTE GetConditionShowKind(LPCTSTR lpszCondName);

index
测试条件的序列号，从 0 开始。

lpszCondName
测试条件名。

BYTE ShowKind=param-> GetConditionShowKind ("Voltage");
BYTE ShowKind1=param-> GetConditionShowKind (0);

14、GetConditionInputKind ()

获取测试条件的输入格式， 0 填空， 1 下拉选择， 2 多选下拉框。

BYTE GetConditionInputKind(int index);

BYTE GetConditionInputKind(LPCTSTR lpszCondName);

index
测试条件的序列号，从 0 开始。

lpszCondName
测试条件名。