TSPI_phoneDevSpecific 函数 (tspi.h)

TSPI_phoneDevSpecific 函数用作常规扩展机制，使电话 API 实现能够提供其他操作中未描述的功能。这些扩展的含义特定于设备。

语法

LONG TSPIAPI TSPI_phoneDevSpecific(
  DRV_REQUESTID dwRequestID,
  HDRVPHONE     hdPhone,
  LPVOID        lpParams,
  DWORD         dwSize
);

dwRequestID

异步请求的标识符。

hdPhone

要对其执行特定于设备的操作的手机的句柄。

lpParams

指向用于保存参数块的内存区域的指针。其解释特定于设备。 lpParams 参数不应包含指针。若要从 TSPI_phoneDevSpecific获取信息回到应用程序，服务提供商会发送包含此信息的PHONE_DEVSPECIFIC 消息。

dwSize

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

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

PHONEERR_INVALPHONEHANDLE、PHONEERR_OPERATIONUNAVAIL、PHONEERR_INVALPOINTER、PHONEERR_NOMEM、PHONEERR_OPERATIONFAILED、PHONEERR_RESOURCEUNAVAIL。

其他返回值特定于设备。

此操作提供泛型参数配置文件。参数块的解释特定于设备。特定于设备的指示和回复应使用 PHONE_DEVSPECIFIC 消息。

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

服务提供商可以通过定义用于此操作的参数来提供对设备特定函数的访问。想要使用这些特定于设备的扩展的应用程序应查阅特定于设备的 (特定于供应商的) 文档，其中描述了定义了哪些扩展。

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


目标平台	Windows
标头	tspi.h