TSPI_lineDevSpecific函数 (tspi.h)

TSPI_lineDevSpecific函数用作常规扩展机制，使服务提供商能够访问其他操作中未描述的功能。 扩展的含义特定于设备，为了利用这些扩展，应用程序必须完全了解它们。

语法

LONG TSPIAPI TSPI_lineDevSpecific(
  DRV_REQUESTID dwRequestID,
  HDRVLINE      hdLine,
  DWORD         dwAddressID,
  HDRVCALL      hdCall,
  LPVOID        lpParams,
  DWORD         dwSize
);

参数

dwRequestID

异步请求的标识符。

hdLine

要在其上运行的线路的服务提供商句柄。

dwAddressID

要在其上操作的指定行上的地址。 地址标识符与地址永久关联;标识符在操作系统升级中保持不变。

hdCall

服务提供商对要操作的调用的句柄。 此字段的值可能为 NULL。 hdCall 的调用状态特定于设备。

lpParams

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

dwSize

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

返回值

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

LINEERR_INVALLINEHANDLE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALADDRESSID、LINEERR_OPERATIONFAILED、LINEERR_NOMEM、LINEERR_RESOURCEUNAVAIL。

注解

其他返回值特定于设备。

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

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

注意lpParams 数据结构不应包含任何指针，因为在 32 位版本的 TAPI 中运行 16 位应用程序时，它们将无法正确转换 () ，反之亦然。

 

服务提供商可以通过定义用于此操作的参数来提供对设备特定函数的访问。 希望使用这些特定于设备的扩展的应用程序应查阅特定于设备的文档 (在这种情况下，这意味着特定于供应商的) ，描述定义了哪些扩展。

注意 依赖于特定于设备的扩展的应用程序在处理其他服务提供商环境时不可移植。 使用特定于供应商的扩展。

 

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

要求

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

另请参阅

ASYNC_COMPLETION

LINE_DEVSPECIFIC

TSPI_lineNegotiateExtVersion