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

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

 

服務提供者可以藉由定義參數來搭配這項作業使用，以提供裝置特定函式的存取權。 在此案例中，想要使用這些裝置特定擴充功能的應用程式應該參閱裝置特定檔 (，這表示描述定義哪些延伸模組的廠商特定) 。

注意 依賴裝置特定擴充功能的應用程式無法在與其他服務提供者環境搭配使用時移植。 使用廠商特定的擴充功能。

 

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

規格需求

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

另請參閱

ASYNC_COMPLETION

LINE_DEVSPECIFIC

TSPI_lineNegotiateExtVersion