通过

TSPI_lineDevSpecificFeature 函数 (tspi.h)

  • 项目

TSPI_lineDevSpecificFeature 函数用作扩展机制，使服务提供商能够访问其他操作中未描述的功能。 这些扩展的含义特定于设备，利用这些扩展需要 TAPI 或其客户端应用程序完全了解它们。

语法

LONG TSPIAPI TSPI_lineDevSpecificFeature(
  DRV_REQUESTID dwRequestID,
  HDRVLINE      hdLine,
  DWORD         dwFeature,
  LPVOID        lpParams,
  DWORD         dwSize
);

参数

dwRequestID

异步请求的标识符。

hdLine

服务提供商对线路设备的句柄。

dwFeature

在线路设备上调用的功能。 此参数使用 PHONEBUTTONFUNCTION_常量。

lpParams

指向用于保存依赖于特征的参数块的内存区域的指针。 此参数块的格式特定于设备。

dwSize

缓冲区的大小（以字节为单位）。 如果 lpParams 参数是指向字符串的指针，则大小必须包含 null 终止符。

返回值

如果发生错误，则返回 dwRequestID 或错误号。 如果函数成功，相应ASYNC_COMPLETION的 lResult 实际参数为零;如果发生错误，则为错误号。 可能的返回值如下所示：

LINEERR_INVALFEATURE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALLINEHANDLE、LINEERR_OPERATIONFAILED、LINEERR_NOMEM、LINEERR_RESOURCEUNAVAIL。

注解

其他返回值特定于设备。 hdCall 的调用状态特定于设备。

此函数为 TAPI 应用程序提供手机功能按钮仿真功能。 当 TAPI 代表客户端应用程序调用此操作时，它指定“按下按钮”事件的等效项。 这种调用功能的方法高度依赖于设备，因为 API 未定义其含义。 当应用程序依赖于特定于设备的扩展时，应用程序无法很好地移植到其他服务提供商环境。

调用此函数是直接响应调用 TAPI lineDevSpecificFeature 函数的应用程序。 TAPI 将 TAPI 级别使用的 hLine 参数转换为 TSPI 级别使用的相应 hdLine 参数。 lpParams 缓冲区通过未修改传递。

注意 在 32 位版本的 TAPI 中运行 16 位应用程序时， lpParams 数据结构不应包含任何指针，因为它们未正确转换 () ，反之亦然。
 
此操作是扩展电话服务的一部分。 它仅提供对特定于设备的功能的访问，而不定义其含义。 仅当 TAPI 已成功协商并选择特定于设备的扩展版本时，此操作才可用。

要求

要求 值
目标平台 Windows
标头 tspi.h

另请参阅

ASYNC_COMPLETION

LINE_DEVSPECIFICFEATURE

PHONEBUTTONFUNCTION_常量