TSPI 设备类
设备类是一组相关的物理设备或设备驱动程序,应用程序通过这些设备或设备驱动程序发送和接收构成调用的信息或数据。 每个设备类都有一个 设备类名称 ,用于唯一标识类,并提供有关编程接口和命令的信息,这些接口和命令可用于打开类中的设备并与之通信。
电话应用程序编程接口 (TAPI) 将设备从一个或多个设备类关联到每条线路或电话设备。 通过使用 lineGetID 或 phoneGetID 函数检索设备的设备标识符来访问其中一个设备。 提供设备类名称,函数返回打开和访问设备所需的特定端口名称、设备名称、设备句柄或设备标识符。 返回的信息的格式取决于设备类,本节对此进行了介绍。
还将设备类名称与 lineConfigDialog 和 phoneConfigDialog 函数结合使用,使用户能够设置给定设备的配置选项;使用 lineGetIcon 和 phoneGetIcon 函数检索表示给定设备的图标;使用 lineGetDevConfig 和 lineSetDevConfig 函数直接检索和设置给定设备的配置选项。
下面是默认设备类名称。
设备类名称 | 说明 |
---|---|
通讯 | 通信端口 |
comm/datamodem | 通过通信端口的调制解调器 |
comm/datamodem/portname | 调制解调器连接到的设备的名称 |
wave/in | 波形音频设备仅 (输入) |
wave/out | 波形音频设备仅 (输出) |
wave/in/out | 波形音频设备,全双工 |
midi/in | MIDI sequencer 仅 (输入) |
midi/out | MIDI sequencer 仅 (输出) |
tapi/line | Line 设备 |
tapi/phone | 电话设备 |
Ndis | 网络设备 |
tapi/terminal | 终端设备 |
这些名称不区分大小写,因此可以使用大写字母和小写字母的任意组合。
其他设备类和设备类名称可能在给定系统上可用。 通常,如果设备不属于默认设备类之一,制造商通常会定义新的设备类并分配唯一的设备类名称。 必须检查设备的文档,以确定哪些其他设备类可供其使用。 但请注意,尽管设备类和媒体类型相关,但它们并不相同。 媒体类型描述调用时的信息格式,设备类定义用于管理该信息的编程接口。 因此,即使制造商定义了新的媒体类型,制造商也必须定义新的设备类才能支持该模式,这也可能不是事实。
与 lineSetDevConfig 和 lineGetDevConfig 函数一起使用的配置数据的格式也取决于设备类。 通常,使用 lineGetDevConfig 保存当前设备配置数据的副本,然后使用 lineSetDevConfig 和保存的配置数据将设备配置还原到以前的状态。 这是一种无需用户手动将配置还原到以前状态的情况下临时更改配置的便捷方法。 由于设备配置数据的确切格式可能因每个服务提供商而异,因此请勿使用 lineSetDevConfig 和 lineGetDevConfig 直接操作设备配置数据。 某些格式仅供信息使用。