SetupComm功能初始化指定通信设备的通信参数。
BOOL SetupComm(
HANDLE 【HFILE】, | //通讯设备的句柄 |
DWORD 【dwInQueue】, | //输入缓冲区的大小 |
DWORD 【dwOutQueue】 | //输出缓冲区的大小 |
); |
参数
【HFILE】
识别通信设备。CreateFile函数返回此句柄。
【dwInQueue】
指定设备内部输入缓冲区的推荐大小(以字节为单位)。
【dwOutQueue】
指定设备内部输出缓冲区的推荐大小(以字节为单位)。
返回值
如果函数成功,返回值不为零。
如果函数失败,返回值为零。要获取扩展错误信息,请调用GetLastError.
备注
一个进程使用CreateFile功能打开通讯设备的句柄后,可以调用SetupComm设置设备的通讯参数。如果不设置它们,则当首次调用另一个通信功能时,设备将使用默认参数。
【dwInQueue】和【dwOutQueue】参数指定驱动程序为指定设备使用的内部缓冲区的推荐大小。例如,YMODEM协议数据包略大于1024字节。因此,对于YMODEM通信,推荐的缓冲区大小可能为1200字节。对于基于以太网的通信,推荐的缓冲区大小可能是1600字节,略大于单个以太网帧。
设备驱动程序接收推荐的缓冲区大小,但可以自由使用任何输入和输出(I / O)缓冲方案,只要它提供合理的性能,并且由于超限而不会丢失数据(极端情况下除外)。例如,即使驱动程序不分配缓冲区,该函数也可以成功,只要操作系统的其他部分提供等效的功能即可。
如果设备驱动程序确定推荐的缓冲区大小涉及超出其处理能力的传输,则该函数可能会失败。
也可以看看