FT_GetComPortNumber函数的用法

介绍FT_GetComPortNumber函数的用法、参数、返回值、注意事项、适用的操作系统环境、调用代码示例等。

支持的操作系统

Windows 2000 以上版本

概述

FT_GetComPortNumber函数获取指定设备分配的对应串口号。

定义

FT_STATUS FT_GetComPortNumber (FT_HANDLE ftHandle, LPLONG lplComPortNumber)

参数说明

ftHandle—设备句柄。

lplComPortNumber—指向LONG类型变量地址的指针，该变量 存储设备对应串口号。

返回值

成功则返回FT_OK,如果失败则根据错误返回特定错误码(FT_*).

备注

FT_GetComPortNumber函数只有 WindowsUSB转串口线驱动程序（CDM driver），而且 D2XX驱动 和 虚拟串口（VCP） 驱动同时安装好的情况下才可用。如果没有为设备分配串口（COM port），参数lplComPortNumber 返回-1。

代码示例

FT_HANDLE ftHandle; // valid handle returned from FT_OpenEx
FT_STATUS ftStatus;
LONG lComPortNumber;

ftStatus = FT_GetComPortNumber(ftHandle,&lComPortNumber);
if (status == FT_OK) {
if (lComPortNumber == -1) {
// No COM port assigned
}
else {
// COM port assigned with number held in lComPortNumber
}
}
else {
// FT_GetComPortNumber FAILED!
}
FT_Close(ftHandle);