TSPI_lineDevSpecific函式 (tspi.h)

TSPI_lineDevSpecific函式可用來作為一般擴充機制，讓服務提供者能夠存取其他作業中未描述的功能。 擴充功能的意義是裝置專屬的，若要利用這些擴充功能，應用程式必須完全了解它們。

語法

LONG TSPIAPI TSPI_lineDevSpecific(
  DRV_REQUESTID dwRequestID,
  HDRVLINE      hdLine,
  DWORD         dwAddressID,
  HDRVCALL      hdCall,
  LPVOID        lpParams,
  DWORD         dwSize
);

參數

dwRequestID

異步要求的標識碼。

hdLine

要運作之行的服務提供者句柄。

dwAddressID

要操作之指定行上的位址。 位址標識符會永久與地址相關聯;標識碼在操作系統升級期間會維持不變。

hdCall

要運作之呼叫的服務提供者句柄。 此欄位可能有 NULL 值。 hdCall 的呼叫狀態是裝置特定的。

lpParams

用來保存參數區塊之內存區域的指標。 此參數區塊的格式是裝置特定的。

dwSize

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

傳回值

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

LINEERR_INVALLINEHANDLE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALADDRESSID、LINEERR_OPERATIONFAILED、LINEERR_NOMEM LINEERR_RESOURCEUNAVAIL。

備註

其他傳回值是裝置特定的值。

這項作業提供泛型參數配置檔。 參數結構的解譯是裝置特定的。 TAPI 一律會指定 hdLine 參數。 dwAddressID 和/或 hdCall 是否必須是裝置特定。 如果指定，它們必須屬於 hdLine。 傳送回給裝置特定使用 LINE_DEVSPECIFIC 訊息的應用程式的指示和回復。

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

服務提供者可以藉由定義參數來搭配這項作業使用，以提供裝置特定函式的存取權。 在此案例中，想要使用這些裝置特定擴充功能的應用程式應該參閱裝置特定檔 (，這表示描述定義哪些延伸模組的廠商特定) 。 這項作業是擴充電話語音服務的一部分。 它只會提供裝置特定功能的存取權，而不需要定義其意義。 只有在應用程式已成功交涉並選取裝置特定的擴充功能版本時，才能使用此作業。

規格需求

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

另請參閱

ASYNC_COMPLETION

LINE_DEVSPECIFIC

TSPI_lineNegotiateExtVersion