TSPI_phoneOpen函式 (tspi.h)

發行項
08/26/2023

TSPI_phoneOpen函式會開啟裝置識別碼為指定的手機裝置，並傳回服務提供者的裝置不透明控制碼，並保留裝置的 TAPI 不透明控制碼，以供後續呼叫PHONEEVENT程式使用。

語法

LONG TSPIAPI TSPI_phoneOpen(
  DWORD       dwDeviceID,
  HTAPIPHONE  htPhone,
  LPHDRVPHONE lphdPhone,
  DWORD       dwTSPIVersion,
  PHONEEVENT  lpfnEventProc
);

參數

dwDeviceID

要開啟的手機裝置。

htPhone

用於後續呼叫 PHONEEVENT 回呼程式的電話裝置 TAPI 不透明控制碼，以識別裝置。

lphdPhone

HDRVPHONE的指標，服務提供者會寫入其控制碼，以供 TAPI 在後續通話中用來識別裝置的電話裝置。

dwTSPIVersion

透過 TSPI_phoneNegotiateTSPIVersion 交涉的 TSPI 版本，服務提供者可以在其中運作。

lpfnEventProc

TAPI 所提供 PHONEEVENT 回呼程式的指標，服務提供者會呼叫來報告手機上的後續事件。

傳回值

如果函式成功，則傳回零;如果發生錯誤，則傳回錯誤號碼。可能的傳回值如下所示：

PHONEERR_ALLOCATED、PHONEERR_NOMEM、PHONEERR_INCOMPATIBLEAPIVERSION、PHONEERR_RESOURCEUNAVAIL、PHONEERR_NODRIVER、PHONEERR_OPERATIONFAILED、PHONEERR_INUSE、PHONEERR_OPERATIONUNAVAIL PHONEERR_INIFILECORRUPT。

備註

開啟電話可讓 TAPI 在手機上提出進一步要求。手機會變成作用中，因為服務提供者可以報告非同步事件，例如勾點變更或按下按鈕。服務提供者會保留管理手機所需的任何不可共用資源。例如，開啟透過 comm 埠存取的手機，數據機應該會導致開啟 comm 埠，使其無法再供其他應用程式使用。

如果函式成功，TAPI 和服務提供者都會認可在此開啟裝置的指定介面版本號碼下運作。使用交換不透明手機控制碼識別的後續作業和事件，都符合該介面版本。此承諾和控制碼的有效性會維持有效狀態，直到 TAPI 使用 TSPI_phoneClose 關閉手機，或直到服務提供者回報 PHONE_CLOSE 事件為止。如果函式不成功，則不會進行任何這類承諾，而且控制碼無效。