TSPI_lineDevSpecificFeature函式 (tspi.h)

TSPI_lineDevSpecificFeature函式可用來做為擴充機制，讓服務提供者能夠存取其他作業中未描述的功能。 這些延伸模組的意義是裝置特定的，而且利用這些擴充功能需要TAPI或其用戶端應用程式完全了解它們。

語法

LONG TSPIAPI TSPI_lineDevSpecificFeature(
  DRV_REQUESTID dwRequestID,
  HDRVLINE      hdLine,
  DWORD         dwFeature,
  LPVOID        lpParams,
  DWORD         dwSize
);

參數

dwRequestID

異步要求的標識碼。

hdLine

服務提供者對線路裝置的句柄。

dwFeature

在線路裝置上叫用的功能。 此參數會使用 PHONEBUTTONFUNCTION_常數。

lpParams

用來保存功能相依參數區塊的記憶體區域的指標。 此參數區塊的格式是裝置特定的。

dwSize

以位元組為單位的緩衝區大小。 如果 lpParams 參數是字串的指標，大小必須包含 Null 終止符。

傳回值

如果發生錯誤，則傳回 dwRequestID 或錯誤號碼。 如果函式成功，則對應ASYNC_COMPLETION的 lResult 實際參數為零;如果發生錯誤，則為錯誤號碼。 可能的傳回值如下所示：

LINEERR_INVALFEATURE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALLINEHANDLE、LINEERR_OPERATIONFAILED、LINEERR_NOMEM LINEERR_RESOURCEUNAVAIL。

備註

其他傳回值是裝置特定值。 hdCall 的呼叫狀態是裝置特定的。

此函式提供 TAPI 應用程式與手機功能按鈕模擬功能。 當 TAPI 代表用戶端應用程式叫用這項作業時，它會指定相當於「按下按鈕」事件。 叫用功能的這個方法與裝置高度相依，因為 API 不會定義其意義。 當應用程式依賴裝置特定的擴充功能時，應用程式不會妥善移植到其他服務提供者環境。

此函式會直接回應呼叫TAPI lineDevSpecificFeature 函式的應用程式。 TAPI 會將 TAPI 層級所使用的 hLine 參數轉譯為 TSPI 層級所使用的對應 hdLine 參數。 lpParams 緩衝區會透過未修改的傳遞。

規格需求

另請參閱

ASYNC_COMPLETION

LINE_DEVSPECIFICFEATURE

PHONEBUTTONFUNCTION_常數