TSPI_lineOpen 函数 (tspi.h)

项目
03/03/2024

TSPI_lineOpen 函数打开为其指定了设备标识符的线路设备，并返回设备的服务提供商的句柄。服务提供商必须保留设备的 TAPI 句柄，以便在后续调用 LINEEVENT 回调过程时使用。

语法

LONG TSPIAPI TSPI_lineOpen(
  DWORD      dwDeviceID,
  HTAPILINE  htLine,
  LPHDRVLINE lphdLine,
  DWORD      dwTSPIVersion,
  LINEEVENT  lpfnEventProc
);

参数

dwDeviceID

标识要打开的线路设备。

htLine

在对 LINEEVENT 回调过程的后续调用中要使用的线路设备的 TAPI 句柄，用于标识设备。

lphdLine

指向 HDRVLINE 的指针，服务提供商在其中填充其线路设备的句柄。

dwTSPIVersion

TSPI 版本。

lpfnEventProc

指向 TAPI 提供的 LINEEVENT 回调过程的指针，服务提供商调用该过程来报告行上的后续事件。

返回值

如果函数成功，则返回零;如果发生错误，则返回错误号。可能的返回值如下所示：

LINEERR_ALLOCATED、LINEERR_OPERATIONUNAVAIL、LINEERR_NODRIVER、LINEERR_OPERATIONFAILED、LINEERR_NOMEM、LINEERR_RESOURCEUNAVAIL。

注解

服务提供商应保留管理线路所需的任何不可共享资源。但是，可以推迟到 lineMakeCall 的任何操作都应为。 TAPI 的设计假设是 lineOpen 是一种“廉价”操作。例如，如果行仅在监视模式下打开，则基于 COMM 端口的服务提供商无需打开 COMM 端口。

此过程不直接对应于 TAPI 级别的任何过程，其中启用特定于设备的扩展、选择行特征和设置媒体类型检测的功能包含在 lineOpen 定义的功能中。在 TSPI 级别，这些附加功能分为 TSPI_lineNegotiateExtVersion、 TSPI_lineSetDefaultMediaDetection 和 TSPI_lineConditionalMediaDetection。