FT_GetDeviceInfoDetail函数的用法

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

null

支持的操作系统

Linux

Mac OS X 10.4 以上版本

Windows 2000 以上版本

Windows CE 4.2  以上版本

概述

该函数返回指定设备的信息,设备信息来自于设备信息列表。

定义

FT_STATUS FT_GetDeviceInfoDetail (DWORD dwIndex, LPDWORD lpdwFlags, LPDWORD lpdwType,LPDWORD lpdwID, LPDWORD lpdwLocId,PCHAR pcSerialNumber, PCHAR pcDescription,FT_HANDLE *ftHandle)

参数说明

dwIndex—设备信息元素在设备信息列表中的索引,从0开始编号。

lpdwFlags—指向存储Flags标志字段的指针。

lpdwType—指向存储设备类型字段的指针。

lpdwID—指向存储设备ID字段的指针。

lpdwLocId—指向存储设备Location ID字段的指针。

pcSerialNumber—字符指针,指向设备序列号(serial number)存储地址;字符串以’\0’为结束标志。

pcDescription—字符指针,指向存储设备描述符的指针;字符串以’\0’为结束标志。

*ftHandle—指向FT_HANDLE类型变量的指针,存储设备访问句柄。

返回值

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

备注

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

dwIndex设备索引从0开始编号。

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_CreateDeviceInfoList创建设备信息列表时,已经被打开的设备,其Location ID信息无法被创建。被其他进程打开的设备,其设备信息无法创建;这种情况下,FT_DEVICE_LIST_INFO_NODE中的Flags字段会标示出设备已经被打开占用,但其他的信息则不会被创建。

如果需要同时获得这个设备信息列表(以FT_DEVICE_LIST_INFO_NODE类型为元素的数组),可以调用FT_GetDeviceInfoList

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

代码示例

FT_STATUS ftStatus;
FT_HANDLE ftHandleTemp;
DWORD numDevs;
DWORD Flags;
DWORD ID;
DWORD Type;
DWORD LocId;
char SerialNumber[16];
char Description[64];
// create the device information list
ftStatus = FT_CreateDeviceInfoList(&numDevs);
if (ftStatus == FT_OK) {
printf(“Number of devices is %d\n”,numDevs);
}
if (numDevs > 0) {
// get information for device 0
ftStatus = FT_GetDeviceInfoDetail(0, &Flags, &Type, &ID, &LocId, SerialNumber,
Description, &ftHandleTemp);
if (ftStatus == FT_OK) {
printf(“Dev 0:\n”);
printf(” Flags=0x%x\n”,Flags);
printf(” Type=0x%x\n”,Type);

       printf(” ID=0x%x\n”,ID);
printf(” LocId=0x%x\n”,LocId);
printf(” SerialNumber=%s\n”,SerialNumber);
printf(” Description=%s\n”,Description);
printf(” ftHandle=0x%x\n”,ftHandleTemp);
}
}

 

 

© 版权声明
THE END
喜欢就支持一下吧
点赞0 分享
评论 抢沙发
头像
欢迎您留下宝贵的见解!
提交
头像

昵称

取消
昵称表情代码图片

    暂无评论内容