TSPI_lineOpen函式 (tspi.h)

發行項
03/13/2024

TSPI_lineOpen函式會開啟裝置標識碼為指定的行裝置，並傳回服務提供者的裝置句柄。服務提供者必須保留裝置的 TAPI 句柄，以供後續呼叫 LINEEVENT 回呼程式使用。

語法

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

參數

dwDeviceID

識別要開啟的線路裝置。

htLine

用於後續呼叫 LINEEVENT 回呼程式的 LINE 裝置 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。