lineGetDevCaps 函数 (tapi.h)

项目
03/09/2024

lineGetDevCaps 函数查询指定的线路设备以确定其电话功能。返回的信息对线路设备上的所有地址都有效。

语法

LONG lineGetDevCaps(
  HLINEAPP      hLineApp,
  DWORD         dwDeviceID,
  DWORD         dwAPIVersion,
  DWORD         dwExtVersion,
  LPLINEDEVCAPS lpLineDevCaps
);

参数

hLineApp

使用 TAPI 注册应用程序的句柄。

dwDeviceID

要查询的线路设备的标识符。

dwAPIVersion

要使用的电话 API 的版本号。高序字包含主版本号;低序字包含次要版本号。此数字由 lineNegotiateAPIVersion 获取。

dwExtVersion

要使用的特定于服务提供商的扩展的版本号。此数字由 lineNegotiateExtVersion 获取。如果不使用特定于设备的扩展，则可以将其保留为零。否则，高序字包含主版本号;低序字包含次要版本号。

lpLineDevCaps

指向类型 LINEDEVCAPS 的可变大小结构的指针。成功完成请求后，此结构将填充线路设备功能信息。在调用 lineGetDevCaps 之前，应用程序必须设置此结构的 dwTotalSize 成员，以指示 TAPI 可用于返回信息的内存量。

注意如果结构中的大小参数不正确，则有可能覆盖数据。有关设置结构大小的详细信息，请参阅内存分配主题。

返回值

如果请求成功，则返回零;如果发生错误，则返回负错误号。可能的返回值为：

LINEERR_BADDEVICEID、LINEERR_NOMEM、LINEERR_INCOMPATIBLEAPIVERSION、LINEERR_OPERATIONFAILED、LINEERR_INCOMPATIBLEEXTVERSION、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALAPPHANDLE、LINEERR_STRUCTURETOOSMALL、LINEERR_INVALPOINTER、LINEERR_UNINITIALIZED、LINEERR_NODRIVER、LINEERR_OPERATIONUNAVAIL、LINEERR_NODEVICE。

注解

在使用 lineGetDevCaps 之前，应用程序必须协商要使用的 API 版本号，并根据需要协商要使用的扩展版本。

API 和扩展版本号是 TAPI 和服务提供商必须在其下运行的版本号。如果版本范围不重叠，则应用程序、API 或服务提供程序版本不兼容，并返回错误。

此函数返回的 LINEDEVCAPS 结构中的一个成员包含分配给指定线路设备的地址数。用于引用单个地址的实际地址标识符从零到 1 不等，比返回的数字少一个。每个地址的功能可能不同。对每个可用的 <dwDeviceID 和 dwAddressID> 组合使用 lineGetAddressCaps 来确定每个地址的确切功能。请注意，地址标识符与地址永久关联;标识符在操作系统升级中保持不变。