lineDevSpecific 函数 (tapi.h)

  • 项目

lineDevSpecific 函数使服务提供商能够访问其他 TAPI 函数未提供的功能。 扩展的含义特定于设备，利用这些扩展需要应用程序完全了解它们。

语法

LONG lineDevSpecific(
  HLINE  hLine,
  DWORD  dwAddressID,
  HCALL  hCall,
  LPVOID lpParams,
  DWORD  dwSize
);

参数

hLine

线路设备的句柄。 此参数是必需的。

dwAddressID

给定线路设备上的地址标识符。 地址标识符与地址永久关联;标识符在操作系统升级中保持不变。

hCall

调用的句柄。 此参数是可选的，但如果指定此参数，则它表示的调用必须属于 hLine 线路设备。 hCall 的调用状态特定于设备。

lpParams

指向用于保存参数块的内存区域的指针。 此参数块的格式特定于设备，其内容由 TAPI 传递到服务提供商或从服务提供商传递。

dwSize

参数块区域的大小（以字节为单位）。

返回值

如果函数以异步方式完成，则返回一个正请求标识符;如果发生错误，则返回负错误号。 如果函数成功，则相应LINE_REPLY消息的 dwParam2 参数为零;如果发生错误，则为负错误数。 可能的返回值为：

LINEERR_INVALADDRESSID、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONFAILED、LINEERR_INVALLINEHANDLE、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALPOINTER、LINEERR_UNINITIALIZED、LINEERR_NOMEM。

其他返回值特定于设备。

注解

此操作是扩展电话服务的一部分。 它提供对设备特定功能的访问权限，而无需定义其含义。 仅当应用程序已成功协商特定于设备的扩展版本时，此操作才可用。

此函数提供泛型参数配置文件。 参数结构的解释特定于设备。 dwAddressID 和/或 hCall 是否应有效是特定于设备的。 如果指定，则它们必须属于 hLine。 发送回特定于设备的应用程序的指示和答复应使用 LINE_DEVSPECIFIC 消息。

服务提供商可以通过定义用于此函数的参数来提供对设备特定函数的访问。 如果应用程序希望使用这些特定于设备的扩展，应查阅特定于设备的 (，在这种情况下，请查阅特定于供应商的) 文档，其中描述了定义了哪些扩展。 通常，依赖于这些特定于设备的扩展的应用程序无法与其他服务提供商环境一起使用。

谨慎 当返回LINE_REPLY消息时，TAPI 会将返回的数据写入 lParam 引用的缓冲区。 这意味着缓冲区必须保持有效，直到返回LINE_REPLY消息;否则，可能会出现数据损坏和异常。
 

要求

   
目标平台 Windows
标头 tapi.h
Library Tapi32.lib
DLL Tapi32.dll

另请参阅

扩展电话服务参考

LINE_DEVSPECIFIC

LINE_REPLY

TAPI 2.2 参考概述