介绍FT_CyclePort函数的用法、参数、返回值、注意事项、适用的操作系统环境、调用代码示例等。
支持的操作系统
Windows 2000 以上版本
概述
FT_CyclePort函数发送重启命令,断开然后重连USB端口。
定义
FT_STATUS FT_CyclePort (FT_HANDLE ftHandle)
参数说明
ftHandle—设备句柄。
返回值
成功则返回FT_OK,如果失败则根据错误返回特定错误码(FT_*).
备注
FT_CyclePort 函数的执行效果相当于断开USB设备的连接,然后重新连接USB设备。
当发生致命错误而且必须断开然后重连才能恢复时,可用 FT_CyclePort 函数实现;或者当对EEPROM进行了重新编程,内容被改写,需要FTDI设备加载新的EEPROM内容时,也可通过调用 FT_CyclePort 函数来实现;以避免物理性的断开和重连。
由于当前访问信息不会被保存,调用 FT_CyclePort 函数重启USB设备后,应用程序需要负责关闭设备访问句柄。
对于设备型号 FT4232H、 FT2232H 和 FT2232 , FT_CyclePort 函数只在 Windows XP 及以上版本操作系统上有效。
代码示例
FT_HANDLE ftHandle; // valid handle returned from FT_OpenEx
FT_STATUS ftStatus;
ftStatus = FT_CyclePort(ftHandle);
if (ftStatus == FT_OK) {
// Port has been cycled.
// Close the handle.
ftStatus = FT_Close(ftHandle);
}
else {
// FT_CyclePort FAILED!
}
暂无评论内容