基于动态链接库的FAMOS二次开发方法研究

ＦＡＭＯＳ是德国ＩＭＣ公司早在１９８８年就推出的以 ＭＳ Ｗｉｎｄｏｗｓ为操作系统的数据信号分析软件。
ＦＡＭＯＳ提供了包括ＦＦＴ、积分、微分、曲线图、直方 图、相位互相关、数字运算等复杂的实时分析功能。用户可 定义的实时测量功能可在线进行测量公式编辑。测量、分析 等工作能在不同的窗口中与波形同时显示并随波形变化 而更新。它可读取多家公司的文件格式，如：ＳＯＮＹ、ＴＥＡＣ、 ＹＯＫＯＧＡＷＡ？ＮＥＣ？ＨＩＯＫＩｊＢＯＳＣＨ？Ｔｅｋｔｒｏｎｉｘ？ＯＲＯＳ？ＨＰ？ Ｎｉｃｏｌｅｔ等，也可通过文件助理（Ｆｉｌｅ Ａｓｓｉｓｔａｎｔ）读取其他 文件格式。其内部的数据转换快速而方便，使用时可将采 集到的数据转换为Ｍｉｃｒｏｓｏｆｔ Ｏｆｆｉｃｅ格式，如Ｗｏｒｄ、Ｅｘｃｅｌ 或其他流行的数据处理软件格式，以供进一步的分析和 编写测试报告。测试者在测试现场即可作出最准确的判断 和完美的测试报告。
／／函数返回存放生成波形的内存块对应的旬柄值
ｅｘｔｅｒｎ”掣一ｄｅｃｌｓｐｅｃ（ｄｌｌｅｌｐｏｒｔ）ＨＡＮＤＬＥ ＲｅｔＳｉｎｅ（ｆｌｏａｔ ａ，
ｉｎｔ ｎ１
ｆ
ＤＬＬ—ＷＡＶＥ ｆａｒ｝ｈｐＣｕｒｖｅ；
ＨＡＮＤＬＥ
ｈＣｕｒｖｅ；
ｄｏｕｂｌｅ
ＰＩ＝３．１４１５９，ｄｘ＝０．００１，ＮｏＯｆＰｏｉｎｔｓ＝２￥Ｐ１，
Ｐｒｏｊｅｃｔ”新建一个工程ＤＬＬＴＥＳＴ，包含２个输出函数。
／／ＤＩ，Ｉ，ＴＥＳ一１．ｃｐｐ
／／波形乘２函数 ｅｘｔｅｒｎ”ｃ”一一ｄｅｃｌ叩。ｃ（ｄｌｌｅｌｐｏｒｔ）ｖｏｉｄ Ｍｕｌｔ２（ＤＬＬ—ＷＡＶＥ
ＦＡＲ｛Ｐ１１
／／函数的输出有２种方法：①可采用包含导出函数表的对应 ／／模块定义文件＋ｄｅｆ，即通过赋一个数值（序号）给链接程序
ｉｎｔ、ｕｉｎｔ？ｌｏｎｇ ｕｌｏｎｇｊ ｃｈａｒｊｕｃｈａｒ？ｆｌｏａｔ？ｄｏｕｂｌｅ、ｔｅｘｔ？ｄｓｆ？
ｖｏｉｄ共１ ３种。其中ｔｅｘｔ是指长度２５５字节的文字信息， ｄｓｆ足指具有ＤＬＬ—ＷＡＶＥ形式的数据结构体。 ３．２动态链接库的编制
ＤＬＬ的种类很多，凡是导出函数符合ＦＡＭＯＳ审数导 人原则的动态链接库，就町以在ＦＡＭＯＳ中正常使用，这 其中包含ＷＩＮ３２ ＤＬＬ及ＭＦＣ ＤＬＬ。用户可在ＤＬＬ中添 加对话框等ＭＦＣ类库资源并进行多个函数的输出， ＦＡＭＯＳ对导人函数的个数没有限制。
ｆｘ，ｌｅｎｇｔｈ；
ｌｏｎｇ ｃｈａｒ
Ｉｘ； ７ｔｅｘｔ［２５５］；
ｌｅ“ｇｔｈ＝ｇｉｚｅｏｆ‘Ｄ１．Ｌ—ＷｈＶＥ）＋（ｉｎｔ）（ｎ·ＮｏＯｆＰｏｉｎｔｓ／ｄｘ）＋
～８一
ｓｉｚｅｏｆ（ｆｌｏａｔ）； ｈｃｕｒｖｅ＝ｃｌｏｂａｌＡｌｌｏｃ（ＧＨＮＤ，（１０ｎｇ）ｌｅｎｇｔｈ）； ／／分配空问 ｉｆ（ｈＣｕｒｖｅ） ｛ｓｐｒｉｎ叫Ｔｅｘｔ，”返回正弦波幅值为：％ｇ、１１周期为：２ＰＩ”，ａ）；
ＦＡＭＯＳ自身的模块加载定义文件｝，ｄｅｆ的定义格式
如下：
ＤＬＬ３２”ＤＬＬＮａｍｅ，ＦｃｔＮａｍｅ ＦａｍｏｓＮａｍｅ， ＲｅＡｃｃｅｓｓ ＲｅＴｙｐｅ——ＤＬＬ．ＲｅＴｙｐｅ．—ＦＡＭＯＳ ＲｅＮｕｍｂｅｒ ｅｌｅｍｅｎｔｓ，
Ｐａｒｌ一Ａｃｃｅｓｓ Ｐａｒｌ一Ｔｙｐｅ—ＤＬＬ．ＰａｒｌＪｙｐｅ
ＦＡＭＯＳ Ｐａｒｌ——Ｎｕｍｂｅｒ＿ｅｌｅｍｅｎｔｓ，
ＦＡＭＯＳ包含二类函数调用约定，即ｃ和Ｐａｓｃａｌ。这二 者的区别是：ｃ约定规定参数传递顺序是从右到左，即最 右边的参数最先压栈，由调用者恢复堆栈指针；而Ｐａｓｃａｌ 约定正好相反，它规定参数是从左向右传递，由被调用者 恢复堆栈。通常情况下，３２位ＤＬＬ函数的导入使用Ｃ调 用约定，而１６位ＤＬＬ函数的导人则使用Ｐａｓｃａｌ约定。 ２．２开发过程
使用中需注意： （１）某些参数在定义时可省略表示，但空格不能省去。 （２）ＤＬＬ外部传送的指针必须是远指针ＦＡＲ。 根据各个参数的具体含义．该动态链接库的ＦＡＭＯＳ 模块定义文件ｆａｍｏｓ．ｄｅｆ为：
ＭｅｓｓａｇｅＢｏｘ（Ｏ，Ｔｅｘｔ，”ＤＬＬ ｆｕｎｃｔｉｏｎ：ＦａｔＣｏｓ”，ＭＢ—ＯＫ）； ｈｐＣｕｒｖｅ＝（ＤＬＬ＿ＷＡＶＥ ＦＡＲ＋）ＧｌｏｂａｌＬｏｃｋ（ｈＣｕｒｖｅ）；
／／锁定内存块 ｌｓｔｒ。ｐｙ（ｈｐｃｕｒｖｅ一＞ｘＵｎｉｔ，”ｓ”）；
ｌｓｔｒ。Ｐｙ（ｈｐｃⅢｅ一＞ｙＵｎｉｔ，”ｖ”）；
（１）根据需要编制动态链接库；（２）编制ＦＡＭＯＳ特定 加载方式对应的模块定义文件；（３）在ＦＡＭＯＳ中加载 ＤＬＬ；（４）在ＦＡＭＯＳ函数分类窗口中添加对应函数组和 函数按钮。 ３实例说明
编写动态链接库的工具很多，如Ｖｉｓｕａｌ ｃ＋＋、Ｂｏｒ— ｌａｎｄ Ｃ＋＋、Ｄｅｌｐｈｉ等，对于具体方法可以参见相关文档。 下面仅以Ｖｉｓｕａｌ ｃ＋＋６．０为例，介绍开发应用于ＦＡＭＯＳ 的３２位动态链接库时应注意的问题。 ３．１ ＦＡＭＯＳ的函数导入原则
／／来导出函数；②采用ＭＦＣ提供的修饰符号一ｄｅｃｌｓｐｅｃ（ｄｌｌ一
／／ｅｘｐｏｒｔ） ｛ｌｏｎｇ ｉ；
ｆｏｒ（ｉ＝Ｏ；ｉ＜ＰＩ－＞Ｓａｍｐｌｅｓ；ｉ＋＋） ＰＩ一’ｙ【ｉ】十＝２；
ＭｅｓｓａｇｅＢｏｘ（Ｏ，”数据己进行了乘２运算”，。ＤＬＬ ｆｕｎｃｔｉｏｎ： Ｍｕｈ２”．ＭＢ—ＯＫ）；
／／产生正弦波形函数（参数ａ为波形幅值，ｎ为周期个数）
ＦＡＭＯＳ的应用窗口界面中包含几个部分：菜单项、工 具条、变量列表窗口（Ｖａｒｉａｂｌｅｓ）、函数分类窗口（Ｆｕｎｃｔｉｏｎｓ）、 操作窗口（Ｏｐｅｒａｔｉｏｎ）、公式解说器输出窗口（Ｏｕｔｐｕｔ），同时 它还包含了报告生成器、结果编辑器等配套组件。 ２ ＦＡｎＯＳ二次开发技术介绍
ＦＡＭＯＳ包含了二次开发接口，即它可利用用户编制 的动态链接库或ＩＭＣ公司提供的信号分析套件来扩充自
在编制ＤＬＬ之前，首先应了解ＦＡＭＯＳ函数导入原则。
—— ＇——
万方数据
（１）使用ＥＡＭＯＳ的波形数据存储定义。在果，必须使用
ＦＡＭＯＳ的波形数据结构体ＤＬＩ．一ＷＡＶＥ。 （２）函数参数和返回值的数据类型必须符台ＦＡＭＯＳ
导人函数的数据类型要求，其数据类型包括ｓｈｏｒｔ、ｕｓｈｏｒｔ、
Ｄｉｒｅｃｔ：直接方式，…１’（默认，可省略表示）；（２）Ｐｏｉｎｔｅｒ：指
针方式，“｝”ｆ一般用于对现有波形的操作）；（３）Ｈａｎｄｌｅ：句 柄方式，“＋”（一般用于函数产生波形的返回）。
Ｔｙｐｅ—ＤＬＬ包含了１３种数据类型．其中包括ＦＡＭＯＳ 自身定义的数据类型ｄｓｆ和ｔｅｘｔ。ｄｓｆ类型是指其数据方式 为结构体ＤＬＬＷＡＶＥ。对应数据访问方法一般为ｐｏｉｎｔｅｒ 或ｈａｎｄｌｅ。ｔｅｘｔ类型是指长度２５５字节的文字信息，它必 须通过远指针ＦＡＲ进行访问，即数据访问方法为ｐｏｉｎｔｅｒ。
ｓｈｏｒｔ Ｆｌａｇｓ； Ｓａｍｐｌｅｓ； Ｔｉｍｅ： ｙ［１】；
／／未定义 ／／采样次数，）＝２Ｌ ／／触发时间．默认为０ ／／采样阵列的开始点
ｌ ＤＬＬ—ＷＡＶＥ；
＃ｐｒａｇｍａ ｐａｃｋ（） 步骤３：编译生成加载于ＦＡＭＯＳ中的ＤＬＬＴＥＳＴ．ｄｌｌ
文件。 ３．３编制ＦＡＭＯＳ加载方式对应的模块定义文件
下面以具有简单输出函数的ＤＬＬ为例说明添加函数 的基本方法。虽然在实际应用中添加函数的方法更复杂且 更有意义，但其方法和动态链接库中添加函数的基本方法 足一样的。
功能要求：完成返回一个正弦波形，其周期为２Ｐ１、波 形长度和幅值可定并且可对波形进行乘２运算这二种函 数功能ＤＬＬ的编制。
步骤１：利用ＶＣ６．０中的３２位ＤＬＬ“ａ ｓｉｍｐｌｅ ＤＬＬ
ｔｙｐｅｄｅｆ ｓｔｒｕｃｔ
｛
ｃｈａｒ
ｃｈａｒ
ｘＵｎｉｔ［１３ｌ； ｙＵｎｉｔ［１３】－
／Ｉｘ轴单位 ／／ｙ轴单位
ｃｈａｒ ｆｌｏａｔ ｆｌｏａｔ
Ｎａｍｅ【１２］；
／／波形名称
ｄＸ；
／／ｘ轴增量．测量间隔＞０．０
ＸＯ；／／ｘ轴偏移量，即第一次采样ｘ的坐标
ｕｎｓｉｇｎｅｄ ｌｏｎｇ
ｌｏｎｇ ｆｌｏａｔ
《傲参２机与应用）２００Ｓ年第１ １期
已的函数库。本文只介绍利用动态链接库对ＦＡＭＯＳ进行 二次开发的方法。 ２．１ ＦＡＭＯＳ＝次开发接口介绍
（１）动态链接库的连接方式。应用程序采用隐式链接 和显式链接方式使用ＤＬＬ。ＦＡＭＯＳ对于ＤＬＬ连接采用显 式链接。ＦＡＭＯＳ菜单项中“Ｏｐｔｉｏｎｓ／ＤＬＬ Ｆｕｎｃｔｉｏｎｓ……” 功能就是对ＦＡＭＯＳ模块定义文件进行操作，完成对应 ＤＬＬ的加载或释放。
ｈｐｃｕｒｖｅ一’ｙ【ｌｘ】＿（ｎｏａｔ）（ａ·ｓｉｎ（ｆｘ））； ＧｌｏｂａｌｕｎＩｏｃｋ（ｈＣｕｒｖｅ）；／／解锁内存块Ｊ
ｒｅｔｕｒｎ ｈＣｕｒｖｅ； ｌ
步骤２：定义波形数据结构体。
／／ＤＬＬＴＥＳＴ．ｈ
＃ｐｒａｇｍａ ｐａｃｋ（１） ／／定义结构ＤＬＬ—ＷＡＶＥ，其中包含了测量的数值和其他一 ／／些附加信息
（２）动态链接库导出函数的调用方式。Ｗｉｎｄｏｗｓ动态 链接库是包含数据和函数的模块，可以被其他可执行文 件（ＥＸＥ、ＤＬＬ、ＯＣＸ等）调用。动态链接库包含２种函数： 输出（Ｅｘｐｏｒｔｅｄ）函数和内部（Ｉｎｔｅｒｎａｌ）函数。输出函数可以 被其他模块调用，而内部函数则只能在动态链接库内部 使用。信号分析软件ＦＡＭＯＳ具备标准的ＤＬＬ接口，允许 导人任何由Ｗｉｎｄｏｗｓ动态链接库导出的函数。
ｂｐＣｕｒｖｅ一＞Ｎａｍｅ［Ｏ】＝０； ｈｐＣｕｒｖｅ一＞ｄＸ＝（ｆｌｏａｔ）ｄｘ； ｈｐＣｕｒｖｅ一＞Ｘ０＝０： ｈｐＣｕｒｖｅ一＞Ｆ１８９８＝０； ｈｐＣｕｒｖｅ一＞ｓａｍｐｌｅｓ＝（１０“ｇ）（ｎ＋ＮｏＯｆＰｏｉｎｔｓ／ｄｘ）； ｈｐＣｕｒｖｅ一＞Ｔｉｍｅ＝０； ｆｏｒ（Ｉｘ＝０，ｆｘ＝０；ｆｘ＜（ｎ十ＮｏＯｆＰｏｉｎｔｓ）；ｌｘ＋＋，ｆｘ＋＝ｄｘ）
基于动态链接库的ＦＡＭＯＳ二次开发方法研究
西安工业学院计算机科学与工程系（７１ ００３ ２） 于志华 雷志勇
摘要：ＦＡＭＯＳ软件是为测试技术的特殊要求而定制的一套信号分析软件。本文重点介绍了 在ＦＡＭＯＳ二次开发中使用动态链接库的实现方法。