FT_CreateDeviceInfoList函数的用法

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

支持的操作系统

Linux

Mac OS X 10.4 以上版本

Windows 2000 以上版本

Windows CE 4.2  以上版本

概述

该函数创建设备信息列表，返回接入系统的D2XX设备个数。设备信息列表中同时包含打开的和未打开的设备的信息。

定义

FT_STATUS FT_CreateDeviceInfoList (LPDWORD lpdwNumDevs)

参数说明

lpdwNumDevs      unsigned long 类型指针,指向的存储空间用于存储系统当前连接的设备个数。

返回值

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

备注

应用程序可以使用该函数获取连接到系统的设备个数。然后为设备信息列表分配空间并使用 FT_GetDeviceInfoList 或FT_GetDeviceInfoDetail来获取.

接入系统的设备发生改变时，设备信息列表不会自动更新，需要重新调用FT_CreateDeviceInfoList来创建.

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

代码示例

FT_STATUS ftStatus;

DWORD numDevs;

// create the device information list

ftStatus = FT_CreateDeviceInfoList(&numDevs);

if (ftStatus == FT_OK) {

printf(“Number of devices is %d\n”,numDevs);

}

else {

// FT_CreateDeviceInfoList failed

}