FT_GetDeviceInfoList函数的用法

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

汉印FT800作业打印机家用小型学生a4迷你迷小型手持宿舍家庭错题A4热敏无线手机蓝牙便携式天猫精灵一体机帮
内置天猫精灵系统 花一台机器钱 当两台用! | 月销量1003件
优惠价348元
原价¥899

淘口令:

¥QIJmXcvr7ba¥
 

支持的操作系统

Linux

Mac OS X 10.4 以上版本

Windows 2000 以上版本

Windows CE 4.2  以上版本

概述

该函数返回设备信息列表,以及列表中包含的D2XX设备的数量。

定义

FT_STATUS FT_GetDeviceInfoList ( FT_DEVICE_LIST_INFO_NODE *pDest, LPDWORD lpdwNumDevs )

参数说明

*pDest—–指向FT_DEVICE_LIST_INFO_NODE类型的数组。

lpdwNumDevs—–指向存储数组元素个数的地址的指针。

返回值

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

备注

调用该函数前必须先调用FT_CreateDeviceInfoList创建设备信息列表。 接入系统的设备发生改变时,设备信息列表不会自动更新,需要重新调用FT_CreateDeviceInfoList来创建。

调用FT_CreateDeviceInfoList创建设备信息列表时,已经被打开的设备,其地址编号信息无法被创建。被其他进程打开的设备,其设备信息无法创建;这种情况下,FT_DEVICE_LIST_INFO_NODE中的Flags字段会标示出设备已经被打开占用,但其他的信息则不会被创建。

FT_DEVICE_LIST_INFO_NODE的Flags字段是一个4字节的位图(bit数组),其包含很多的信息,详情请查阅附录A-类型定义。标志位0标示设备是否被打开(打开时为1,否则为0);标志位1标示设备是高速USB设备(即USB2.0最大480Mbps,位值为1)还是全速USB设备(即USB1.1最大12Mbps,位值为0);其他标志位(2-31)保留。

FT_DEVICE_LIST_INFO_NODE数组包含每个设备可获取的信息,其结构组成在附录中给出说明。其结构体实例的存储空间需要程序进行分配;分配空间时,可以根据函数FT_CreateDeviceInfoList返回的设备个数来确定空间大小。

在用Visual Basic, LabVIEW 或 其他类似的编程语言和环境中编程时,可能需要用FT_GetDeviceInfoDetail代替FT_GetDeviceInfoList 。

请注意,Linux, Mac OS X 和 Windows CE 不支持地址编号;此种情况下,地址编号参数字段为空。使用时要注意选用的操作系统。

代码示例

FT_STATUS ftStatus;
FT_DEVICE_LIST_INFO_NODE *devInfo;
DWORD numDevs;
// create the device information list
ftStatus = FT_CreateDeviceInfoList(&numDevs);
if (ftStatus == FT_OK) {
printf(“Number of devices is %d\n”,numDevs);
}
if (numDevs > 0) {
// allocate storage for list based on numDevs
devInfo = (FT_DEVICE_LIST_INFO_NODE*)malloc(sizeof(FT_DEVICE_LIST_INFO_NODE)*numDevs);
// get the device information list
ftStatus = FT_GetDeviceInfoList(devInfo,&numDevs);
if (ftStatus == FT_OK) {
for (int i = 0; i < numDevs; i++) {
printf(“Dev %d:\n”,i);
printf(” Flags=0x%x\n”,devInfo[i].Flags);
printf(” Type=0x%x\n”,devInfo[i].Type);
printf(” ID=0x%x\n”,devInfo[i].ID);
printf(” LocId=0x%x\n”,devInfo[i].LocId);
printf(” SerialNumber=%s\n”,devInfo[i].SerialNumber);
printf(” Description=%s\n”,devInfo[i].Description);
printf(” ftHandle=0x%x\n”,devInfo[i].ftHandle);
}
}
}

© 版权声明
THE END
喜欢就支持一下吧,技术咨询可以联系QQ407933975
点赞0
分享
评论 抢沙发