FT_CyclePort函数的用法

介绍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!
}