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 緩衝區會透過未修改的傳遞。

注意lpParams 數據結構不應包含任何指標，因為它們在 32 位版本的 TAPI 中執行 16 位應用程式時，不會正確轉譯 (thunked) ，反之亦然。

 

這項作業是擴充電話語音服務的一部分。 它只會提供裝置特定功能的存取權，而不會定義其意義。 只有在 TAPI 已成功交涉並選取裝置特定的擴充功能版本時，才能使用此作業。

規格需求

需求	值
目標平台	Windows
標頭	tspi.h

另請參閱

ASYNC_COMPLETION

LINE_DEVSPECIFICFEATURE

PHONEBUTTONFUNCTION_常數