高速PCI信号采集卡设计与实现综合实例之：主机应用程序和驱动程序的接口设计

用于返回当前终端状态，其函数原型为：

RETURN_CODEPlxIntrStatusGet(

HANDLEhDevice,//已打开的PCI设备的句柄

PLX_INTR*pPlxIntr); //含有需要指定的中断信息的数据结构（PLX_INTR）

10．PlxIntrWait函数

用于等待中断，并可设定等待时间长度，其函数原型为：

RETURN_CODEPlxIntrWait(

HANDLEhDevice,//已打开的PCI设备的句柄

HANDLEhEvent,//被等待的事件句柄

U32Timeout_ms//为等待的时间长度，单位为ms

);

由于此函数只能用在Linux系统中，因此在Windows系统中使用PLXAPI函数包等待中断时，使用另外两个WindowsAPI函数进行中断等待，即WaitSingleObject（）函数和WaitMultipleObject（）函数。

11．PlxDmaSglChannelOpen函数

用于开启Scatter/Gather模式DMA通道，其函数原型为：

RETURN_CODEPlxDmaSglChannelOpen(

HANDLEhDevice,//已打开的PCI设备的句柄

DMA_CHANNELchannel,//为被开启的DMA通道

DMA_CHANNEL_DESC*pDesc);//包含DMA通道的参数描述结构体（DMA_CHANNEL_DESC）指针

12．PlxDmaSglChannelClose函数

用于关闭已经打开的Scatter/Gather模式DMA通道，其函数原型为：

RETURN_CODEPlxDmaSglChanneClose(

HANDLEhDevice,//已打开的PCI设备的句柄

DMA_CHANNELchannel);//将要关闭的已被开启的DMA通道

13．PlxDmaSglTransfer函数

用于开始进行Scatter/Gather模式的DMA传输，其函数原型为：

RETURN_CODEPlxDmaSglTransfer(

HANDLEhDevice, //已打开的PCI设备的句柄

DMA_CHANNELchannel, //进行Scatter/Gather模式DMA传输的通道

DMA_TRANSFER_ELEMENT*dmaData, //指向用于DMA数据缓冲区结构(DMA_TRANSFER_

//ELEMENT)指针

BOOLEANreturnImmediate); //取值为FALSE表示程序等待DMA传输结束后再执行下一

//条指令

//，反之，则不等待结束就执行下一条指令

13.5.3API函数调用

有了这些丰富的API函数资源，用户即可根据自己的需要为信号采集设备设计功能多样的应用程序。在进行应用程序的设计时，只需要将API函数库包含在用户的程序中即可。

PLX公司提供的PLXSDK开发包中包含了完整的API函数库文件。将这些API库文件复制到用户的应用程序目录下，并在程序中include进去，即可调用这些API函数。更多的函数及用法详见PLXSDK的编程者开发手册。

13.5.4PCI9054驱动程序安装

INF文件是安装设备驱动程序时必须使用的文件，其扩展名为.inf。驱动程序安装后将它保存在windows/inf目录中，是Winodws操作系统下用来描述设备或文件等数据信息的文件。

INF文件全称InformationFile文件。在操作系统发现新硬件之后向系统指明应该安装的驱动程序，系统为设备提供的服务以及注册表项要修改的内容。它为该设备提供一个全面描述硬件参数和相应驱动文件(动态链接库等文件)的信息。

驱动程序安装的最终结果包括对系统的两个永久更改。

·描述驱动程序的系统注册表项、它的卸载顺序以及任何正确的配置资料。

·将驱动程序文件复制到一个指定的系统目录中。

INF文件是由标准的ASCII码组成，可以用任何一款文字编辑器查看修改其中的内容。它是分节的，每节以“[]”扩起来，每一个节名最长为255个字符（Windows2000/XP/2003操作系统中）或28个字符（Windows98操作系统中）。

节与节之间的内容叫条目，每一个节是由许多的条目组成的。每一个条目都由“=”分开，如“a=b”。如果每一个条目的等号后有多个值，则每一个值之间用逗号分隔开。INF对大小写不敏感，行注释语句命令是“；”，类似VisualBasic里的“’”。如果一行写不下，使用“\”来换行。更多关于INF文件的规则和说明可以查看WindowsDDK的说明，这里不再详述。

通过INF文件，用户可以允许系统自动安装信号采集设备的驱动程序，或者在对话支持下按照系统安装向导一步一步完成驱动程序安装过程。